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Introducing ProtoGen+. Visual tools with the most awesome 
workbench ever created for Windows development. 


he future has arrived—a complete 
point-and-click, WYSIWYG 
workbench that lets you create 
dazzling applications without 
writing a line of code. 

Paint your 
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Bring your applications to life using the latest 
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development! 
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workbench access to multiple 
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development technologies—whatever 
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speeds your development cycle and 


The most powerful, open set of 
Visual Development Tools ever! 


Build win¬ 
dows. forms, Dialog 

dialog boxes. Editor 

tool bars 


Quickly 
Menu ; create a 
Designer menu using 
templates 


Output C, 
C++ and 
Pascal with 
Objects 


Code 

Gener¬ 

ator 


ProtoView 

Screen 

Manager 


Data valida¬ 
tion, 3-D 
effects, MDI 
and more 


protects your investment by generat¬ 
ing C,C++ and Pascal. We guarantee 
you'll 
prototype 
and generate 
exciting 
applications 
faster than 
you ever 



rasra 

STATIC 
j text 

SSSU £ 

E= ♦ 

Hi 



PUSH 

BUTTON 

(?) : 

1 

□ 

(Tape 


Create new 
designers! 
Source 
included 


Custom 

Visual 

Designer 


Win- 

Control 

Library 


Rich library 
of visual 
control 
objects 


Snap-in 

Code 

Generators 

js&isiidwiitf 


License our technology to 
create new code generators 


Point-and-click to paint 
screens with bitmaps, 
icons, tables, data valida¬ 
tion, custom colors, fonts, 
3D effects, visual tool¬ 
bars, status lines, balloon 
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Take the direct path to ODBC with Q+E Software. 


Simplified and standardized database 
access... that’s the promise of ODBC. But 
you have to get there first. It’s easy to get lost 
in the search for reliable ODBC drivers. And 
trying to write ODBC-enabled applications 
without the proper tools can lead you straight 
into a dead end. 

Q+E Software puts an end to the frustra¬ 
tion and confusion. We’ll lead you through 
the maze of possibilities with a comprehen¬ 
sive solution for all your ODBC driver and 
development needs. With Q+E you can get 
what you need out of ODBC without getting 
lost in the process. 

Connect ODBC-compliant applications no 
matter what you find around the corner. 

With Q+E ODBC Pack, you can take 
advantage of the same database access tech¬ 
nology we provide for such leading software 
publishers as Lotus, Computer Associates, 
Sybase, INFORMIX, and PowerSoft. Q+E 
ODBC Pack offers a comprehensive suite 
of drivers for more than 30 SQL and PC 
DBMS versions. 

And, as new ODBC applications come out, 
Q+E Software will continue to take you 


where you need to go. Each of our drivers is 
fully supported and kept absolutely up-to-date 
by our technical support staff. 

Count on a robust ODBC development tool 
that removes the obstacles in your way. 

When it comes to making sure your appli¬ 
cations are ODBC-compliant, you can rely 
on the same technology that WordPerfect, 
Delrina Technology, Crystal Services, and 
dozens of other prominent software compa¬ 
nies use. Q+E Database Library gives you an 
easy way to build ODBC-enabled applica¬ 
tions—no matter what development environ¬ 
ment you prefer. 

You can forget about differences in drivers, 
because our development tools let you write 
code once that works with all major databases. 
And because Q+E Software keeps up with the 
constantly changing technology, you won’t be 
left on your own when custom applications 
need modification. 

Turn to Q+E Software for your total 
ODBC solution. 

Whether you’re looking for ODBC drivers 
or planning to build ODBC applications, 

Q+E Software offers the path that’s fast, easy, 


Q.+E ODBC Pack and Q.+E Database Library provide dependable 
and complete support for the following databases: 

ALLBASE, Btrieve, Clipper, DB2, DB2/2, DB2/6000, dBASE, Excel .XLS files, FoxBase, FoxPro, Gupta 
SQLBase, IMAGE/SQL, INFORMIX, INGRES, Microsoft SQL Server, NetWare SQL, Oracle 6 and 7, 
Paradox, PROGRESS, SQL/400, SQL/DS, Sybase System 10, Sybase SQL Server, Teradata, Text files, and 
XDB. Gateways supported include IBM DDCS/2, Micro Decisionware, and Sybase NetGateway. 

Not all DBMS are available on all platforms; some may require a gateway. Call for details. 


and direct. Our ODBC solution is multi- 
platform, with versions for Windows, OS/2, 
Macintosh, Windows NT, and Solaris. And 
we offer single-source technical support for 
more databases than anyone in the industry. 

When it comes to ODBC, Q+E Software 
gets you there now. No delays. No confusion. 
No walls. 


Find out more about 
Q+E Software today! 
Request a FREE copy of 
Qetting Connected — 
An ODBC Primer. 
Call 1-800'876'3101, 
ext. D030, 8 am to 8 pm EST. 
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Computing" 
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800-876-3101, (919) 859-2220, Fax (919) 859-9334 
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An RTF Preprocessor. 5 
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"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi - PC Magazine 


Discover the secrets the insiders use 
with Windows Source! 

Learn the numerous undocumented 
functions used by the professionals to 
perform tricks that are otherwise im¬ 
possible! 

Windows Source™ generates detailed 
listings of Windows EXEs, DLLs, and 
VxDs. See the actual Windows func¬ 
tion names used within the programs. 

Windows Source includes the follow¬ 
ing special features: 

❖ Identifies all imported function 
calls, including Windows API calls. 

❖ Labels all exports from an execu¬ 
table, DLL or device driver. 

❖ Includes Codeview symbols when 
available. 

❖ Identifies, by name, the VxD API 
entry points and services provided. 

❖ Describes DPMI, DOScall and 
VMM interrupt subfunctions. 

There is no way to get better commented 
assembly source code from Windows 
programs. Bundled with Sourcer for 
DOS binary file disassembly. 

Just $229.95! 

Call 800-648-8266 
to order now! 


m 
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V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 275-WD 
San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 



From 

the Editor 


Everybody talks about what a dog Windows is for graphics, but Microsoft is finally 
doing something about it; WinG is a new library that Microsoft claims will deliver fast 
graphics. Go to the WINMM forum, Library 12 on CompuServe, and download file 
uing.zip, which contains the handbook 'Writing HOT Games for Microsoft Windows' in 
several file formats. Microsoft predicts a beta version of the WinG library itself will appear 
in that forum before you read this. ♦♦ But one humorous paragraph in the WinG 
documentation implies that if your app messes up because the customer's sound card is 
not completely Windows-compliant, Microsoft support will handle the question! ♦♦ 
Say, exactly how does IBM's OS/2 for Windows work? Let's face it, you might sleep 
better not knowing, but the fearless among you can check out Andrew Schulman's Un¬ 
documented Corner in the June Dr. Dobb's Journal, which explores the gory details. On the 
bright side, patching Windows on the fly probably won't make my machine crash any 
more often than it does already. ♦♦ In the geeks are where you find them depart¬ 
ment, the May 5 edition of the Kansas City Star reports that 'Apple founder Bill Gates is 
definitely not a geek'. Bill also founded IBM when he was 5 years old and started Lotus 
when he reached puberty - Microsoft is just something he does in his spare time. ♦♦ 
Windows Unicode is painful to support, largely because it ignores the fact that a lot of 
C/C++ software assigns special meaning to key ASCII values (such as NULL to terminate 
strings, 7' or A' in filenames, '%' in printfO formats, and so on). In the May 1994 
Embedded Systems Programming, P. J. Plauger describes an encoding scheme called FSS- 
UTF that supports character sets as large as 32 bits per character, while allowing much 
existing software to work as-is (because no 7-bit ASCII character ever appears as part of 
a multi-byte sequence). Cross-platform GUI development tools might see this scheme as a 
way to provide a layer of multi-language support without inflicting a lot of work on the 
programmer. ♦♦ Speaking of Unicode, check out William S. Hall's latest effort, a multi¬ 
part article starting in the June issue of Microsoft Systems Journal. He's about the best 
source of concrete Windows international programming information I've found. For 
trivia buffs, can you spot my name in that issue of MSJ ? ♦♦ A company called Lone 
Star Evaluation Labs points out a hardware bug in the Cyrix 80486 clone, in an article in 
the June issue of WINDOWS Magazine (LSEL plans to sell a full report of their comparison 
of Intel, AMD, and Cyrix CPUs this month for $29.95 - send email to 72134.3003@com- 
puserve.com for info). ♦♦ Speaking of bugs, we've decided we're never going to get rid 
of them, so we might as well get acquainted with them - with our new Bug of the 
Month departments. This is a way to spread the word about bugs (and workarounds, 
when available) in Windows, Windows NT, Windows device drivers, or your Borland/Sy¬ 
mantec/Microsoft C++ compiler. More importantly, this is a way for you to get a free 
T-shirt. If you send us a bug that we use, you will be the proud recipient of our most 
sought-after W/DDJ apparel. One size (XL), one color (purple), and the back is embla¬ 
zoned with an original design from Kansas artist T. Watson Bogaard. □ 


Ron Burk 

Editor 

CIS: 70302,2566; Internet: ronb@rdpub.com ("... iuunetirdpubironb") 
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Software Tools 



An RTF Preprocessor 


David Spector 


I had been wanting to be able to write my own true Windows help files for 
many months, without having to spend hundreds of dollars for one of the 
several interactive help-writing systems available on the market. The Windows 
SDK online help documentation provides a description of the low-level RTF 
commands that the help compiler accepts to create help files. However, RTF is 
complicated enough that you would not generally want to type help compiler 
input by hand. What i needed was a tool to tame this complexity. I came up 
with a simple and very fast macro expander, called HLPMAC. This article de¬ 
scribes the input that HLPMAC accepts for creating RTF files, and provides com¬ 
plete source code. 

How HLPMAC Works 

The source to HLPMAC is in hlpmac.c (Listing 1); you give it a source file that 
contains macros and ordinary text and it produces an output file that contains 
an appropriate RTF file that the help compiler will accept. The source and ex¬ 
ecutable are available on the code disk (see the Online Source Code box in the 
table of contents). 

HLPMAC works by comparing text in the input file to a table of hard-coded 
strings (macros). The table in hlpmac.c is just an array of string pointers named 
macros. Macros in the input file must start with a or "#'. When the code 
encounters a macro in the input file, it gathers up any arguments and then 
inserts the corresponding macro definition from the macros table. Wherever the 
macro definition contains a "%1', the code inserts the actual first argument of 
the input file macro invocation, and so on. 

How to Use HLPMAC 

Table 1 shows the list of macros that HLPMAC recognizes. Start your .mac file 
with a .start macro and end it with a . end_of_help_fi 1 e macro. As you create 
each hypertext jump macro (.j, .jl, .p, or .pi) in a topic, immediately create a 
dummy topic entry to follow the entry you are working on (use the .ent and 
.end macros - or .pent and .end, if it is a definition), and put a unique string 
inside the dummy entry (I use 'zz'). When you finish writing each help topic 
entry, just search for the next occurrence of your unique string to find the next 
unfinished entry to work on. When there are no more 'zz's left, the help com¬ 
piler should run without detecting any errors. 

After you have written a .mac file, run HLPMAC to generate a .rtf file. 
demo.mac (Listing 2) shows a sample .mac file that I created. To produce a .rtf 
file from demo.mac, I typed: 

hipmac demo.mac demo.rtf 


David Spector has been programming small computers for 27 years. During the last 14 
years he has been a compiler writer. In the last year David has been offering Windows 
development tools through his own company, Springtime Software. You may contact 
him there at (617) 894-9455. 
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winPAK - The C++ Custom Controls 


Finally there are controls created expressly for Windows C++ 
programmers. winPAK unleashes the full power of C++. winPAK controls 
are FAST! winPAK is compatible with Borland C++, Visual C++ and 
Symantec C++. Borland C++ programmers even get access to the winPAK 
internals, can derive their own new classes from winPAK, and override 
internal features. Try that with a VBX control! winPAK is a single DLL that is 
fully compatible with Borland Resource Workshop. Look at winPAK’s 
impressive lineup: 


A Full-Featured Spreadsheet 



Part No. 

Description 

Unit Price 

i. 

* 

1 

PCL-2-50 

* 2 Pencils 

4.95 

2 

ERS-1-12 

Pencil eraser 

2.25 

3 

PAPWHT-8 

White Paper 

1.99 

4 

MSPAD-1 

Mouse Pad 

0.75 

5 

PEN-3-10 

Black pen 

2.49 

6 

STPL-3 

Office stapler 

2.35 





tU_14 



1- It’s a spreadsheet! Connect 
cells together with expressions. 

2- It’s a grid! Connect it to any 
ODBC-compliant database, 
without any need to code! 

3 - It’s a virtual listbox! Up to 2 
billion items. 

Use the mouse at runtime to change 

cell, column or row properties. 


Bitmaps galore: in radiobuttons, 
checkboxes and listboxes. Use 
our winPAK controls as direct 
replacements for the standard 
controls. Use the hierarchical 
listbox for outlines and trees. Full 
horizontal scrolling is supported 
automatically. 


Bitmapped Windows Controls 



Instrumentation Controls 



winPAK has all kinds of controls for 
analog variables: faders, gauges, 
completion status bars, knobs. 
winPAK has the best looking 
controls in the business. winPAK 
gives you full control over how each 
item looks on the screen, with little 
or no coding necessary! 


winPAK has everything for data 
entry. Let winPAK check characters 
and do range checking or data 
conversion for you. winPAK handles 
strings, picture-template strings, 
integers and floating point numbers. 
winPAK’s error reporting is 
unsurpassed! 


Validated Data Entry 



Properties, Properties ! 


EE 



E3 B 


All winPAK controls are compatible 
with Resource Workshop. Each 
control has its own set of detailed 
and easy-to-use property sheets, to 
let you tune each control with 
immediate feedback. Certain 
controls even have a proprietary 
Integrated Designer. 


Little or no coding needed - Just add winPAK controls to your resource file, 
and we take it from there. Properties are usually established under 
Resource Workshop, but runtime changes can also be made. 


winPAK comes with 19 bullet proof controls - We even make the 
source code available! So what are you waiting for ? Call our order desk at 
(800) 500-6535 to order! winPAK is priced at only $249.95. winPAK with 
source code is $499.95. VISA or MasterCard accepted. Fax your order to 
(714) 854-6459, or use CompuServe at 76350, 1013. Call for a free demo 
disk. winPAK comes with a 30 day money-back guarantee. No royalties. 


faisoir 

computing 


4199 Campus Dr. # 550 Irvine, CA 92715 
Tel (714) 854-6535 Fax (714) 854-6459 
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Note that hlpmac.exe is a Windows application, so either 
hardcode the command-line parameters via Program Man¬ 
ager or use the Run command. Alternatively, if you have a 


Listing 1 hlpmac.c — Soure code to RTF 
preprocessor 


♦Include <windows.h> 

♦include <stdl1b.h> /* exitO */ 

♦include <std1o.h> /* fopenO, etc. */ 

/* List macros from longest name to shortest! */ 

/* All macros must start with . or ♦! */ 

/* In macro expansions: Double all BSs; use \n for newlines 
In .RTF output */ 

/* Standard page format */ 

♦define STD "WpardW11180Wr1180\n" 

LPSTR macros[] = { 

".end_of_help_f11e=} 

/* .start(l:label,2=top1c,3=bitmap file,4=program name) */ 
".start={WrtfWansi\n" 

"{Wfonttbl \n" 

" {Wf0Wf roman MS Sans Serif;}\n" 

" {WflWfswiss Arlal;}\n" 

" {Wf2\\fdecor Fixedsys;}\n" 

" {WftWfdecor Symbol ;}\n" 

TSTD 

"♦{Wfootnote Xl}\n" 

"${\\footnote X2}\n" 

"K{ Wfootnote X2}\n" 

"\\fl\n" 

"Wfs64\n" 

"WkeepnXn" /* Make top of Contents non-scrolling */ 

"X4 WstrikeWtbmc X3WHWv 1con}Wstr1ke0\n" 

"Wf0\n" 

"\\par\n" 

"Wfs48\n" 

"Table of ContentsXn" 

"Wpar\\fs24\\tx540\n"STD, 

".pent=^{\\footnote %l}\n" 

"$ {Wfootnote X2 (def.)}\n" 

"KtWfootnote X2 (def.)}\n"STD. 

".ent=^{Wfootnote Xl}\n" 

"${\\footnote X2}\n" 

"K{Wfootnote X2}\n" 

"Wfs48\n" 

"\\keepn\n" 

"X3X2\n" 

"Wfs24\n" 

"Wpar\n"STD 

"Wpar", 

".top=K{Wfootnote XI}", 

".end=\\page\n", 

".bmp=W{bmc X1W}", 

",rem=", 

Mn=W11720Wf1-360\n", 

/* Diamonds: */ 

/*"itf=Wpar{Wf3\nW'a8}Wtab\n". */ 

/♦"♦b=Wpar{Wf3\n\\'a8}WtabWbXnXlWb0\n: \n". */ 
"♦♦=Wpar{Wf3\nW’b7}Wtab\n". 
"♦b=Wpar{Wf3\nW’b7}Wtab\\b\nXlWb0\n: \n". 
"♦n=\\par\\b\nXl.Wb0\\tab\n", 

".un=\\par"STD, 

\[=Wf2Wfs30\n", 

".]=Wf0\\fs24\n", 

".s=\\par\n\\par\n", 

".n=\n\\par\n", 

".jl={Wuldb XlHWv XI}". 

".j={\\uldb X2HWv XI}". 

".pl={Wul XlHWv XI}". 

".p={Wul X2HWv XI}". 

".b=\n\\b\nXl\n\\b0\n", 

NULL}; 

♦define NAMEJND 
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LAUNCH BAR SIMPLIFIED RUN MENU 

FrontRunner’s Launch Bar offers Run Menu offers Program Manager functionality 
one-button launching of your favorite without navigating through all those open windows! 

applications. Customize it any way . 

you like! 


HISTORY 

Scroll to view the complete 
history of your DOS session. 


COPY & PASTE 

Just highlight and click to copy and 
paste any part of your DOS session into 
a Windows or DOS program. 


COMMAND LINE POWER 

Run DOS or Windows programs right 
from the DOS prompt! 

POWERFUL REAL TIME 
STATUS BAR 

4 

FrontRunner’s Status Bar displays 
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. 
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Windows... And the Power 
of Windows to DOS 

Frustrated with switching between 
Windows and DOS applications? Now 
you can get the command-line power 
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you run Windows programs directly 
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Program Manager, lets you launch 
applications with a click, keeps custom 
information at hand with Phar Lap’s 
unique Status Bar, and much more! 
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FrontRunner’s powerful features... 
absolutely free! So call today and see 
how exciting a winning DOS desktop 
can be! 


"** v Phar Lap Software, Inc. 


60 Aberdeen Avenue, Cambridge, MA 02138 617-661-1510 FAX: 617-876-2972 


Phar Lap® and FrontRunner® are registered trademarks of Phar Lap Software, Inc. All other product names and company names are trademarks or registered trademarks of their respective holders. 

□ Request 263 on Reader Service Card □ 












































shell like Phar Lap's FrontRunner, you can just run this (or During the short time that F1LPMAC runs it will change the 
any) Windows program directly from the DOS command cursor to the hourglass cursor. When the cursor returns to 
prompt. 


Listing 1 continued 

/* Standard declarations */ 


define EQ == 

args = (format; 

♦define NE 1= 

args++; 

^define NUL ’\0* 

wvsprintf(text. format, args); 

typedef unsigned long L; 

PRINT(textl. "Sorry. Xs.", (LPSTR)text); 

typedef unsigned short S; 

MessageBoxtNULL, textl, app name. MB TASKMOOAL 

^define PRINT wsprintf 

1 MB ICONSTOP 1 MB OK); 

#define STRCPY lstrcpy 

exit(l); 

^define STRNCPY _fstrncpy 

} /* error */ 

#define STRLEN lstrlen 


#define STRCAT lstrcat 

/* Called by ERR macro */ 

tfdefine STRCHR fstrchr 

void int error(L line, LPSTR file) 

^define STRCMP lstrcmp 

t 

^define STRCMPI lstrcmpi 

error("internal error on line Xld in file Xs", line, file); 

#define ERR int_error(_LINE_, _FILE_) 

} /* 1nt_error */ 

/* Global declarations */ 

/* Show/hide WAIT cursor */ 

LPSTR app_name = "HLPMAC"; 

HCURSOR orig cursor; 

HINSTANCE instance; 

void start wait(void) 

//define TEXTLEN 256 

t 

#define LONGTEXTLEN 1024 

if (orig cursor) 

HWND desk, cur dig; 

return; 

char from[TEXTLEN]; 

orig cursor = SetCursortLoadCursorCNULL. IDC WAIT)); 

char to[TEXTLEN]; 

) /* start wait */ 

typedef FILE * STREAM; 

void end wait(void) 

STREAM ffrom, fto; 

t 

#define MAXARGS 9 

if (lorig cursor) 

LPSTR arg[MAXARGS]; /* arg[0] is XI. etc. */ 

return; 

short line; 

SetCursor(orig_cursor); 


orig cursor = NULL; 

/* Error message dialog */ 

} /* end wait */ 

void error(LPSTR format, ...) 


t 

/* Used by parse_args() */ 

LPSTR far * args; 

LPSTR get next_pos(LPSTR * arg_pos) 

char textl[TEXTLEN]; 

t 

char text[TEXTLEN]; 

if (**arg_pos) 
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SOFTI/l/AREi 1 »Ic| W 

The Leader in Defect Management 

Telephone: (719) 598-3713 Fax: (719) 598-3970 

□ Request 101 on Reader Service Card □ 

Page 8 — Windows/DOS Developer’s Journal 




Full-Text Toolkit 


The infoLink Library adds high performance 
text indexing and retrieval to your application. 

V It’s Fast! Boolean searches take less than one 
second, regardless of the size of the database. 

▼ Boolean, Phrase, and Proximity searches can be 
performed. Nested searches and wild card searches 
are also available. 

▼ Low Overhead indexes (with all words indexed) are 
typically 10% of the size of the original text. 

▼ DOS, Windows and MAC platforms. 

Great for applications in Visual Basic, Visual C++, C++, or C. 

JtaHnfoLink 

. TECHNOLOGIES 


750 N. 200 W. Provo, Utah 84601 
(801) 375-7507 Fax (801) 375-7537 

EE 

□ Request 224 on Reader Service Card □ 

July 1994 


- 426-3277 




















Sometimes you'll find you are 
held buck by the limitations of 
using Visual Basic alone. 



f 


With the help of Crescent 
Software you can now reach 
your highest goals with ease. 


A 


We can only drop you a line, 
if you drop us one (1-800-35-BASIC). 


If you use Visual Basic because it allows 
you to create real, quality Windows appli¬ 
cations quickly with minimal effort, then 
you'll want to use Crescent Software's 
add-on tools for those same good reasons. 

We've been providing reliable software 
solutions to Basic programmers for nearly 
8 years, so we know what tools you need 
and how to deliver them to you. Plus, our 
products come with complete source code 
and example programs so you can learn 
how we write expert Visual Basic code. 

So, if you're ready, grab a hold of Crescent 
Software's Visual Basic product line, you'll 
like what you see at the top! 

"For a professional programmer writing sophisticated, real world 
applications, QuickPak Professional is a treasure trove." 

- Windows Magazine, 1993 

QuickPak Professional for Windows ($199) includes 30+ Custom 
Controls, 400+ DLL routines, 2.7 MB of sample code, 3+ MB of 
source code, 1,000 pages of documentation (2 separate volumes), 
and several time saving utilities for Visual Basic. With this kind 
of unprecedented power, you can quickly create show stopping 
Windows-based applications with ease! 

_ Most of the custom controls are data- 

aware. Included are masked edit controls, 
enhanced list box, and scroll bars, a cal¬ 
endar control, spin button, command 
button, and our unique form management 
control, and more! 

Separate common dialog controls are pro¬ 
vided that are easier to use and more 
powerful than those supplied with 
Microsoft’s Professional Toolkit 
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ff Visual Basic ($99) generates listings of all keywords, 
forms, controls, properties, events, methods, variables, arrays, 
constants, and procedures by type and scope - even across 
seperate modules. 

It automatically recognizes properties and events of custom 
controls, as well as all Visual Basic 3.0 data objects. A 
unique call-tree report identifies your procedures showing the 
the hierarchy of procedures that are pres¬ 
ent but never used, and it also gener¬ 
ates a formatted listing of your source 
code complete with headers, footers, and 
a table of contents. 




XRef for 
Visual Basil 


NetPak 

Professional 


» 


QuickPak 

Professional 




More than 400 DLL routines cover a 
broad spectrum of services including array searching, multi-key 
array & file sorting (including huge arrays); file and directory 
services; string parsing, searching and formatting; financial and 
statistical functions; missing memory functions such as Peek, 
Poke, Inp, Out Cvx, Mkx, (including Mbf versions), VarSeg 
VarPtr, SSeg SAdd, InterruptX and much, much more. 
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Apex Software's Standard Edition bound grid control is now 
bundled with QuickPak Professional for Windows. A $69 Value 
FREE with every purchase! 


XRef can also extract quoted strings and/ 
or remarks from your source code and 
save them in a separate text file that 
can then be merged back into your pro¬ 
gram through most spell checkers. 

_ Corrected text can then be merged back 

into your program with the supplied utility program. 

Reports can be viewed with the built-in file browser or sent 
directly to your printer. XREF is an outstanding tool for doc¬ 
umenting and managing complex applications, and can save 
you hours of work. 

"The fact that less than 60 seconds are required to create 
a terminal emulator, suitable for communicating with most 
computers, is indicative of PDQComm's power." 

- BASICPro Magazine, 1993 
PDQComm for Windows ($149) is based on the MSComm 
control that Crescent Software, Inc wrote for Microsoft's 
Visual Basic Professional edition, and it adds several im¬ 
portant enhancements. 

Included are background file transfers 
using ZModem, YModem, XModem, 
CompuServeB+, or Kermit protocols, 
optional display of a status dialog box 
with a percent-complete meter, and TTY, 
ANSI, DEC VT100 and VT52 terminal 
emulations. All of these features are 
extremely easy to use - just add the 
PDQComm control to a form, set a few 
properties, and within 30 seconds you're 
dialing to your favorite on-line service! 

PDQComm for Windows also includes a 64K scroll-back buffer 
session logging, and a complete set of Visual Basic routines 
for handling modems (including a database of commands for 
nearly 450 modems). Extensive documentation and examples 
are provided, C source code is also available. 
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For international orders, choose from our list of 
authorized dealers at the bottom of this page. 


Professional for Windows ($179) provides seamless 
access to many NetBIOS, NetWare, and Windows for Work¬ 
groups network services. This product provides a compre¬ 
hensive collection of 100+ network functions that help the 
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capabilities to their programs written in Visual Basic. 
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bindery functions; NetWare QMS functions; 
NetWare Connection functions; NetWare 
Workstation and File Server Environment 
functions; NetWare Message and Directory 
functions, NetWare TTS and 386 (F2) spec¬ 
ific functions; Windows Built-In functions; 
Windows for Workgoups functions and 
Miscellaneous Windows API functions. 




The combination of Visual Basic for Win¬ 
dows and NetPak Professional is the fastest 
way to write network-aware and network specific applications. 

PE 

NetPak Professional received the 1994 readers choice award 




. 19841 by the readers of Fawcette Technical Publications Visual Basic 

RlMtirC Choice Programmers journal. 


"Until recently, there has been no truly useful scientific pro¬ 
gramming toolbox for Visual Basic programmers. That's where 
QuickPak Scientific for Windows makes it’s grand entrance." 

- BASICPro Magazine, 1993 

Each QuickPak Scientific for Windows ($149) routine offers a 
flexible and easy to use Basic-Language algorithm to help dev¬ 
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science, and other technical applications. Function categories 
include linear and matrix algebra, differential equations, non¬ 
linear equations, curve fitting, fast Fourier transforms, numerical 
integration, and the especially challenging 
area of numerical optimization. 

There are also provisions for statistical 
computations, manipulation of complex 
numbers, advanced trigonometry functions, 
and vector mathematics. Utility programs 
and routines are included to perform cap¬ 
abilities with Julian dates and produce very 
attractive, yet simple, plots of functional 
data. Complete source code is included, 
along with comprehensive demonstration 
programs for each routine. 
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Table 1 Built-in HLPMAC macros 


.start(label,topic,bitmap_file,application_name) 

This macro starts a .mac file and produces an attrac¬ 
tive header for the Table of Contents topic, label and 
topic are as described for the .ent macro. bitmap_file 
is the filename of a .bmp file generated from the appli¬ 
cation's main icon by a bitmap editor such as 
pbrush.exe. application_name is the title that will ap¬ 
pear in the header of the Table of Contents topic. 

You must provide a topic entry labeled 'icon' which 
will be jumped to when the user clicks on the icon in 
the Table of Contents header. 

.ent(labeUopicprefix) 

This macro starts a topic entry, label is used to refer 
to it in the .j and .jl macros described below, topic 
is the name that will appear in its header and in the 
Search dialog box; and prefix is a string that will ap¬ 
pear as a prefix in the header (if the topic is 'Frogs' 
and the prefix is 'The ', the header will be 'The 
Frogs' but the entry in the Search dialog box will be 
'Frogs'). The prefix can be an empty string. 

.pent(labeUopic) 

Similar to .ent, but used only for definitions (see .p 
and .pi below). 

.end 

This macro ends a topic entry that was started with 
.ent or .pent. 

.j(label,string) 

Underlines the string and uses it as a jump area. If 
the user clicks on a jump area, the topic represented 
by label is shown on the screen. 

.jl (label) 

Similar to .j - this can be used for brevity when the 
label and the string happen to be identical. 

.p(labelstring) 

Underlines string with a dotted line and uses it as a 
jump area. If the user clicks on a jump area, the topic 
represented by label is shown in a popup window. 
This is used to show definitions. 

.pi (label) 

Similar to .p - this can be used for brevity when the 
label and the string happen to be identical. 

.top(topic) 

Used inside of .ent and .pent entries to add another 
associated topic name to the Search dialog box. 


.bmp(pathname) 

Inserts a named .bmp bitmap file on the current line, 
positioning it as though it were just another character. 

.rem(text) 

Comments out the parenthesized text. 

.in 

Starts an indented text section, which usually con¬ 
tains a list of items. 

.un 

Ends ('undents') an indented text section. 

## 

Represents a bullet for a list item. Is followed immedi¬ 
ately by the text. 

#b(text) 

Represents a list item that starts with the given text 
in boldface. Is followed immediately by the text. 

#n(l) 

Represents a numbered list item. Is followed immedi¬ 
ately by the text. 

.b(string) 

Presents the given string in bold face. 

.[ 

Starts a region of text to appear in a bold, fixed- 
width font, suitable for showing program examples. 

• 1 

Ends a region started with .[. 

.n 

Used at the end of a line, or on a line of its own, to 
indicate the actual end of line. When ./? is not used, 
separate lines are simply run together and used to fill 
whatever WinFielp window width the user has cho¬ 
sen. 


Used between lines to skip a space. If you use .s, 
don't use .n. 

.end_of_help_file 

Marks the end of the text in the .mac file, a 
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an arrow, HLPMAC is done. At this point, run the gener- hc31 demo 
ated .rtf file through the help compiler: 


Listing 1 continued 


return (*arg_pos)++; 

BOOL match strings(LPSTR buffer, LPSTR macro, 

else 

LPSTR * end of match, LPSTR * body) 

return *arg_pos; /* End of line: stay */ 

t 

) /* getjiext_pos */ 

for (ii) 

/* Parse actual args. if any, that follow the macro 

if (‘macro EQ NAME END) 

* name in the sre line, arg[0] is XI, etc. */ 

t 

void parse args(LPSTR * arg_pos) 

*end of match = buffer; 

t 

‘body = macro + 1; /* Skip = */ 

LPSTR next_pos; 

parse argsiend of match); 

int a; 

return TRUE; 

/* Empty all args, for error detection */ 

} /* Macro matches */ 
else if (*buffer++ NE *macroH-) 

for (a = 0; a < MAXARGS; ++a) 

return FALSE; 

arg[a] = NULL; 

} /* Scan macro */ 

next_pos = get_next_pos(arg_pos); /* Skip ’(’ */ 
if (*next_pos NE '(’) 

} /* match_strings */ 

/* Try matching each macro at this point in the line */ 

t 

BOOL match(LPSTR buffer, LPSTR * end of match, LPSTR * body) 

--*arg_pos; /* No args: Restore following char */ 

i 

return; /* No actual args */ 

} 

arg[0] = *arg_pos; /* Start of first arg */ 

LPSTR * macro; 

/* Macros must start with special chars, for speed */ 
if (‘buffer NE V ii ‘buffer NE ’#') 

next_pos = get_next_pos(arg_pos); 

return FALSE; 

for (a = 1; *next_pos ii *next_pos NE ’)’; 

next_pos = get next_pos(arg_pos)) /*Skip final ’)'*/ 

/* Try matching against each macro In list */ 

i 

for (macro = macros; *macro; -i-Hnacro) 

If (*next_pos EQ /* Skip V */ 

if(match_strings(buffer, *macro,end_of match, body)) 

arg[a++] = *arg_pos; 

return TRUE; 

} /* Scan each char */ 

return FALSE; 

/♦Debug: errorCthe first args are 'Xs' ’Xs’ 'Xs'", 

} /* match */ 

arg[0], arg[l], arg[2]); */ 

} // parse_args 

/* Expand a macro body */ 

/* Match buffer against given macro */ 

void expand macro(LPSTR body, LPSTR * pexp) 
t 


FIND YOUR BUGS BEFORE THEY FIND YOU. 


Make project development a X ^rew 
whole lot easier by picking up a WINDOWS 

VERSION!! 


copy of MemCheck®. 

MemCheck pinpoints serious C/ 

C++ bugs that other debuggers don't, 
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Seamless Integration 
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alike. Call 1-800-933-3284 (1-800- 
WE-DEBUG) today to make your software 
apps the best they can be. International 
callers, call +1-313-996-2944. 
Unconditional 30-day money back 
guarantee on all orders! 

MemQheck 

Automatic Erro^Hrection Made Easy 
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Includes full source code! An unbeatable value! 
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This will take much longer to run, especially if your help file similar to demo.hpj (Listing 3). Figure 1 shows the help 

file references bitmap files (the .bmp macro). For help file file that resulted from the input in demo.mac. 

compilation to work, you also need to write a help project 


Listing 1 continued 


LPSTR p; 

skip matched part */ 

int a; 

expand_macro(body, &exp_buffer); 

while (*body) 

buffer = end of match; 

} 

( 

else 

If (‘body EQ X) 

/* Ho match: copy char */ 

( 

*exp buffer++ = *buffer++; 

/* Expand an arg */ 

) /* Scan line */ 

++body; /* Skip X */ 

*exp_buffer = NUL; 

a = ‘body • T; 

} /* expandjine */ 

++body; /* Skip digit */ 


P » arg[a]; 

/* Expand one file to another, overwriting the second */ 

If (Ip) 

void expand(LPSTR to, LPCSTR from) 

errorCtoo few actual macro args--macro name" 

t 

"(arg0, argl, ...)--on line Xd", line); 

NPSTR shortp; 

while (p && *p && *p NE T M *p NE V) 

LPSTR p; 

*(*pexpH+ = *p++; 

L status; 

} 

char buffer[LONGTEXTLEN]; 

else 

char exp buffer[LONGTEXTLEN]; 

*(*pexp)++ = ‘bodyft; 


) 

shortp = ( NPSTR)L0W0RD(from); 

) /* expand_macro */ 

ffrom = fopen(shortp, V); 

/* Expand all macros In current line */ 

If (ffrom EQ NULL) 

errorCfile %s not found", (L)from); 

void expand 1ineCLPSTR buffer, LPSTR exp buffer) 

fto = fopen( ( NPSTR)LOWORD(to), V); 

t 

if (! fto) 

LPSTR end of match, body; 

error("cannot create file Xs", (L)to); 

/* Scan each input char */ 

for (;;) 

( 

while (*buffer) 

p = fgets(buffer, slzeof(buffer), ffrom); 

( 

/♦Debug: errorCfirst line is Xs". (L)buffer); */ 

/* Try matching each macro at this point */ 

/* if (bytes EQ HFILE_ERROR) */ 

If (match(buffer, &end of match, ibody)) 

I* error("cannot read file Xs", (L)from); */ 

t 

if (Ip II !*p) 

/* Match found: expand macro body. 

break; 



Peer to Peer LAN, to 250 nodes ^ 
$75 total software cost! 

No matter how many nodes! < 

Use Ethernet, Arcnet or 

serial/parallel/modem to connect. / 

Mixed mode routing 

Any combination of above connection is possible 
on any given node. 

Use with windows ___________ 

Seen as 100% compatible 
Microsoft Network 
by Windows 3.x. 1 


Information Modes 

P.O. Drawer F 
Denton TX 76202 
817-387-3339 Techline 
817-382-7407 Fax 

1-800-628-7992 Orders 


Lillie Big Lon 


The $25 Network 


TVy the 1st truly low cost LAN 

• Connect 2 or 3 PCs. XTs. ATs, PS/2$ 

• Uses serial ports and 5 wire cable 

• Runs at 1t5K baud, up to 90 feet 

• Transfer 8500 bytes per second (ATs) 

• Runs in background, totally transparent 

• Share any device, any file, any time 

• Needs only 15K of ram 

• Just $25 per network. NOT PER NODE! 

• Replace all fde transfer software 

• Version 2.3P now has TinyMAlL 

• OVER 20,000 SOLD WORLDWIDE 

Skeptical? We make believers! 
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Developer's Toolkit 


Fastest, Most Powerful Text 
Retrieval Technology Available 


Based on ZylNDEX—leader from the beginning 
in PC text retrieval 


Search 1 GB in Less Than 5 Seconds 
Up to SO Million Documents, 10 GB Total Per Index 
Powerful Searches: Word, Phrase, Proximity, Boolean, 
Wild Cards and More 

Works Directly with MS Word, WordPerfect, AmiPro, 
dBASE, ASCII, and Others 


Ideal for use with high-level application development 
environments such as Visual Basic, ToolBook, 
KnowledgePro, and ObjectVision. 


Windows, DOS, and UNIX/386 
libraries available $3,995 


Call for Specs and Demo. 


100 Lexington Drive • Buffalo Grove. IL 60089 
Phone: (708) 459-8000 • Fax (708) 459-8054 
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PowerBuilder. 

Now in a handy desktop size. 



Powersoft” already has the 
best team application development 
tool in the business. The industrial- 
strength PowerBuilder® Enterprise. 
Now we’ve brought the brawn of this widely accepted, 
award-winning success to xBase and desktop developers 
with PowerBuilder Desktop. 

Better yet, we’ve done it in the first package that 
combines a client/server architecture with object-oriented 


support, certification courses, and access to a vast 
network of PowerBuilder Desktop developers like your¬ 
self through CompuServe? user groups, and more. And 
PowerBuilder Desktop provides a strong foundation 
for full-featured team development by simply adding 
our robust companion products, which are listed in 
the column on the right. 

So if you’re searching for a client/server application 
development tool that’s proven, scalable, affordable 



Object Easy 

° Inheritance, 
polymorphism, and 
encapsulation 
° Class libraries 
° Custom controls 
° VBX controls 

SQL Smart™ 

° Integrated database 
administrator and 
dictionary 

° Built-in 32-bit 
Watcom™ SQL 

- Intelligent 
DataWindow™ object 

° Supports popular 
desktop databases 

Developer 

Designed 

° Rapid iterative 
development 

° Complete Windows® 

3.1 support 

° Full MDI support 

° OLE, DDE and DLL 
support 

° Configurable toolbars 
° Extensive on-line help 
° Integrated debugger 
° Robust PowerScript™ 
language with hundreds 
of extensible functions 

° Royalty-free deployment 
(deployment kit free 
with registration) 

Tools for 
Scalable Team 
Development 

° Upgrade seamlessly 
to our enterprise-wide 
client/server environment 
with PowerBuilder 
companion products. 

° PowerBuilder 
Team/ODBC Kit 
° PowerBuilder Enhanced 
Database Kit 
° PowerBuilder 
Application Library 

0 PowerBuilder Developer 
Toolkit 

Databases 

Supported 

° Broad Connectivity - 
In addition to Watcom 
SQL, access the databases 
below using the drivers 
included:"' 

° dBase III, IV 
° Fox Pro 1.x, 2.x 
° Microsoft Access 


programming. The result is the industry’s most powerful, 
graphical desktop development tool available. 

What’s more, you’ll always find a smooth ride down 
the application development road. We’ve paved it with 
innovative programs including automated technical 


($249*), and will fit on your desktop, look no further 
than PowerBuilder Desktop. Find it at CompUSA, 
Egghead, and Micro Center. Or call Powersoft 

at 1 -800-395-3525. P()WGPS0ft 

Building on the power of people. 


° Microsoft Excel 
° Paradox 3.x, 4.x 
° Btrieve 5.x, 6.x 
° ASCII 

° Clipper Summer 87,5.x 
o NetWare SQL 

" Package includes 
Microsoft™ and Q+E™ 
drivers 


Powersoft Corporation, 561 Virginia Road, Concord, MA 01742-2732. Powersoft Europe Ltd., Thames House, 1 Bell Street, 
Maidenhead, Berkshire, SL6 1BU, United Kingdom. "'Introductory price for a limited time only. Prices listed do not include sales tax, 
shipping and handling. All trademarks and registered trademarks are property of their respective owners. 
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How to Customize HLPMAC 

To make the source code fit easily in the magazine, 
HLPMAC has only a crude user interface and a small set 
of macros. You can customize and extend it in any num¬ 


ber of ways. You may want to write macros for some of 
the many other kinds of effects supported in Windows 
help files, such as boxes and horizontal and vertical lines. 
Or you may want to replace the help macros entirely with 


Listing 1 continued 

++1ine; 

return TRUE; 

expandj1ne(buffer, exp_buffer); 

) /* get.args */ 

status = fputs(exp buffer, fto); 


if (status EQ (L)EOF) 

#1fdef BORLANDC 

errorCcannot write file %s". (L)to); 

#pragma argsused 

i 

#endif 

if (Mine) 

/* Main function */ 

errorCcannot read file %s". (L)from); 

int pascal WinMain(HINSTANCE hlnst. HINSTANCE hPrevInst, 

} /* expand */ 

LPSTR pCmdLine, int Show) 

BOOL get arg(LPSTR var, LPSTR * pp) 

/* Main Program starts here */ 

t 

instance = hlnst; 

if (!**pp II **pp EQ ’ ■) 

start_wait(); 

return FALSE: /* End comes too early */ 

if (!get_args(pCmdLine)) 

for (;;) 

errorCusage is: HLPMAC src file dst file"); 

( 

expandlto, from); 

if (! **pp II **pp EQ ’ ’) 

return 0; 

break; 

} /* WinMain */ 

*var++ = *(*pp)++; 


} /* Scan arg */ 

/* Cleanup on exiting Central (called from exitO) */ 

*var = NUL; 

void cleanup(void) 

return TRUE; 

t 

) /* get arg */ 

if (ffrom) 


fclose(ffrom); 

BOOL get args(LPSTR args) 

if (fto) 

( 

fclose(fto); 

if (!get_arg(from, &args) ) 

end_wait(); 

return FALSE; 

} /* cleanup */ 

-H-args; /* Skip blank */ 

/* End of File */ 

If (Iget argtto, Sargs)) 


return FALSE; 



Making C++ more 

COMFORTABLE FOR 


Programmers 



♦ Immediate access to all functions, classes, structures, and 


macros without prior compiling or saving. 

♦ High speed parshing for C.C++, and assembler code 

♦ multiple copy I past buffers 

♦ Bookmarks that work the way you expect them to 

♦ Language sensitive commenting and uncommenting 

SOURCERER-functions are easily accessed using the Visual 
C++ menu by just clicking the mouse. 

Convince yourself. Order today. 



ClB software GmbH ♦ Riesstrufie 17 * 80992 Miinchen I Germany 
Tel.: +491891143 60-0 ♦ Fax: +49189/143 60-/00 ♦ or CIBCompuServ 100065. 165 

Important: Please enclose cheque or money-order. For Fax-orders, or ordering via 
CompuServe, please send enclosed payment by mail. 
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Sax Comm Objects lets you 
write Windows comm, apps 
in no time * 

With Sax Comm Objects, you can save time and add value to 
your Windows applications by plugging in high-level, 
royalty-free comm, objects. 

• X,Y,ZModem, Kermit, CompuServe B+ File transfers 

100% in the background with optional status dialog box 

• Color Ansi, VT52, VT100, TTY emulations with 
capturing, scroll back, and mouse selection. 

• Modem database with over 100 modems, extensive 
modem control functions 

• Common Dialogs for Communications for dial status, port 
settings, dial directory, etc... 

Don't waste another minute with cumbersome, old-fashioned 
programming when Sax Comm Objects can be yours for only 
$299. Call 1-800-MIKESAX for more information. 


* well... ok, maybe five minutes. 



Copyright © 1993. Sax Software. For Visual Basic version of Conun 
Objects, call Crescent Software at (203) 4385300 



SOFTWARE 


1-800-MIKESAX 

Fax: 202-785-3607 Visa/MC welcome 
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We can hardly contain ourselves! 

Because new VERSIONS 1.1 gives you all 
sorts of important new features and 
functionality. Until now most version 
control systems just got in your way. 

But now, with new VERSIONS 1.1 you 
get quick, safe and easy-to-use version 
control. VERSIONS streamlines the 
process of managing all your project 
resources—source code, documenta¬ 
tion, project plans, or anything else 
—either on or off a network. You and 
your whole team are going to love 
VERSIONS, because it’s specifically 
designed for the special problems of 
developing software and other complex 
projects in the Microsoft® Windows™ 
environment. 

Automation makes everything fast and easy 

File check-in and check-out is quick and effortless. 
VERSIONS even suggests which files you need to check in 
or out. So it’s simple to keep your whole team current. 
VERSIONS is network-compatible, supporting multiple 
users within the same project. Long-term locking of pro¬ 
ject resources avoids collisions between users. VERSIONS 
tracks which user did what and provides complete, 
customizable and hassle-free project reporting. VERSIONS 
has visual diffing, delta versioning of ASCII files and a 
DOS command-line interface for easy batch operations. 

Full support for Windows’ binary files- 
and absolutely everything else 

There’s no limit to the number or types of files you can 
maintain. VERSIONS is compatible with all programming 
environments, including Borland’s Paradox, dBASE and 
C++, Microsoft’s FoxPro, Visual Basic, Visual C++, 
PowerSoft’s PowerBuilder, and even Smalltalk image 
files. You name it. And since binary files are supported, 
VERSIONS works with everything else, for example, every¬ 
thing in Microsoft Office—Access, PowerPoint, Word 
and Excel. In short, VERSIONS works for any other 
project materials you need to manage, such as documen¬ 
tation and other word-processing files, CAD and 
graphics files, even spreadsheets. 

Versions 1.1-Check it out 

•A powerful main application window, for point-and-click access to 
launch applications on working files 

• New side-by-side visual diffing for ASCII files 

• New delta versioning of ASCII files 
•New DOS command-line interface makes batch operations easy 

• New Project Wizard simplifies project setup 


“Smart" suggestions on which files need to be 
checked in or out 

• New Automatic project-based scheduled 
check in 

• New Windows File Manager drag-and-drop 
check-in 

• New File filter; file wildcard matching 
inclusion/ exclusion rules 

• New User-definable Build/Test project 
commands 

• Project milestones and project archiving 

• Symbolic version names, such as, 

“Beta One” 

• File descriptions of up to 256 characters 
each 

• Version check-in comments of up to 128 
characters each 

• Fully customizable version history and 
project reporting 

Send notes or files through Microsoft Mail, 
(or other MAPI-compliant system) 

• On-line context-sensitive Windows based help with new hot-spot 
bitmaps and glossary 

• New! Versions now runs under Windows NT 

Here’s what the experts are saying 

“Versions is great for the lone developer, a networked group or even 
non-programmers who need to track, for example, different versions 
of a catalog and the document and image files associated with it. 
“Versions takes a refreshingly different approach. Versions is 
intuitive...excellent tech support...the superb quality of the help 
system; it’s one of the best I’ve seen. Versions is the easiest version 
control product I’ve ever used.” — DataBased Advisor, April 1994 

“Programmers have needed version control tools for a long time, 
and Versions 1.0 gave it to them at a reasonable price. But 
programmers aren’t the only people who work creatively and 
collaboratively. With Versions 1.1, StarBase has made these tools 
available to the rest of us.” — PC WORLD, May 1994 

“...Versions is faster and simpler than other offerings and is well- 
integrated with the Windows environment...” 

—PC WEEK, December 27,1993 

It’s the easiest way ever to control your projects 


The suggested retail price for VERSIONS 1.1 is only $279. 
But if you order before July 31, your special 

introductory price is only $179! So get 
a move on! See your dealer today or 
call (800) 891-3262 in the U.S. or 
Canada. U.K. (0)342 850930. 




S t a r B 


s e 



Versions is a trademark of StarBase Corporation. Other products named herein are trademarks of their respective companies. Product appearance and 
specifications are subject to change without notice. All rights reserved. ©1994 StarBase Corporation 
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Listing 2 demo.mac — Sample input to RTF preprocessor 

.startfmain,Contents,DEM0.BMP,A Brief Demonstration of Help) 


.top(Help) 

.pent(def.Word) 

.topITable of Contents) 

This is the definition of the word. 

.In 

.end 

#.j(word,Defining a Wordl.n 


#.j( number .A Nunbered Listl.n 

.entlnumber,Numbered Lists.Writing ) 

#.j(bold.A Bold-Named Listl.n 

Here is a numbered listr.n 

.un 

.In 

If you are not familiar with Windows Help, choose 

#n(l)All about .j(bold.bold texth.n 

.b(Help)1.b(How To Use Help) from the Help menu now. 

#n(2)Another reference to something .jl(bold)..n 

.end 

.un 


.end 

.entlicon,Version,Help File ) 


This demonstration file written 13 Aug 93 by 

,ent(bold,Bold Text and Bold-Named Lists,) 

David Spector at Springtime Software. 

.topIBold-Named Lists) 

.s 

Here is a bold-named listi.n 

Here is 

.in 

another gratuitous appearance of the DEMO icon: .bmp(DEMO.BMP) 

#b(Saw)Cuts wood into .b(pieces)..n 

.end 

#b(Hamner)Secures nails into .b(wood)..n 

.entlword,Define a Word,Hew To ) 

.end 

This .p(def.word) has a definition. 


.end 

. end_of_hel p_f i 1 e 


macros that make some completely different but similarly 
complex job easier. 

Near the beginning of hlpmac.c you will see an array of 
pointers to strings named macros. Each initialization entry 
represents a separate macro, and has the format 
'macro_name=macro_body'. You can modify the existing 
macros or write your own new ones. You need to obey 
the following rules when writing macros: 


Hockeb into olb 


Wish Your Software Was In 

C ? 


Then Don't Re-Invent the Wheel ! 

Automatically translate your code into readable 
and maintainable C with 
PASCAL and BASIC to C Translators 


Available for most popular variants 

eg. Turbo Pascal, VAX PascaUBasic, Microsoft PascallBasic 

For more information call now! 

Technosoft (US) Technosoft (Europe) 

PO Box 8210 Enterprise House 

Rockford, IL 61126-8210 Cherry Orchard Lane 

Phone:815-397-3214 Salisbury, SP2 7LD 

Phone:011-44-722-414-201 



The macros must be defined in order by their length, 
longest first. This lets you have separate macros that 


Listing 3 Sample help project file 


; DEMO.HPJ 

: Change TITLE and FILES sections for each project 
[OPTIONS] 

TITLE=Demonstration of Help 
COMPRESS=0 
: ERR0RL0G=H ELP. ERR 

[WINDOWS] 

: Size S Pos of Help Window Background Color of Headers 

; I I 

main=,(256,0,767,10231,0,,(128,255,128) 

[FILES] 

DEMO.RTF 


File Edit Bookmark Help 




■■ forck 




A Brief Demonstration 
of Help S 

Table of Contents 


• Defining a Word 

• A Numbered list 

• A Bold-Named I ist 

If you are not familiar with Windows Help, choose HelplHow 
To Use Help from the Help menu now. 


Figure 1 Help file produced from demo.mac 
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about the products advertised 
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corresponding Reader Service 
lumbers. Drop this postage-paid 
card in the mail, or FAX it to 
(913) 841-2624. 
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are prefixes of each other, such as . j 
and .jl, without the possibility of 
mistaken identity. 

• Ail macros must start with or 

This restriction helps make 
HLPMAC run blindingly fast, but 
can easily be relaxed, if you wish, 
by editing and recompiling 
HLPMAC. 

• End the list of macros with a NULL 
entry. 

• If you want to use a backslash 
(*Y) in a macro expansion, don't 
forget to double it, since 'V is an 
escape character. 

• Use '\n' to represent a Newline in 
the .rtf output. 

Conclusion 

When I first tried my hand at writ¬ 
ing Windows Help files, the result 
was a perceptible slipping into the 
quicksand of complicated commands 
and nesting rules known as the Rich 
Text Format. I found that by under- 
standing each RTF construct once 
(usually through experiment) and 
codifying that knowledge in a macro or two, I 
on the job at hand: creating the content and 



could focus the Help file. I hope this tool proves useful to others fac- 

structure of ing similar problems. □ 


TUB Version Control 

For DOS, OS/2 and Windows-NT 


• The experts loved TUB 4: 

"...amazingly fast... TUB is a great system. ” PC Tech Journal 
"TUB has features and power to spare... TUB is easy to use and 
the fastest of the reviewed packages. ” Computer Language 
“/ will not program without it. ” Uptime Magazine 

. TLIB 5.01 adds: 

Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 
And now... automated conversion from PVCS ” or MKS RCS! 

• Plus the features they loved in TLIB 4: 

Check-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon NLs in the file like other 
products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM, Sperry formats. Integrated with industry-leading MAKE 
from Opus'” software. 


MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 

5-user net: DOS $419, OS/2+NT+DOS $595. Call for other sizes. 


Burton Systems Software 



PO Box 4157, Cary, NC 27519 (919) 233-8128 

FAX: 233-0716 


new release** 

More features - - - - 


ToolsKan 


For SDK & Visual Basic 

3D Chart 

- Over 30 of 2D & 3D chart styles 

- Rotation & scrolling 

- Supports printing & clipboard 

Toolbox 

- Creates buttons from bitmaps 
or text 

- Supports scrolling 

- 3D buttons w/ color customization 

- Single/multiple/no-state button 
groups 

Ribbon 

- 3D items with color customization 

- Supports combobox, text, & buttons 

Field Validation 

- Validates date, time, number fields 
& "PIC" statements 

Meter 

- Creates vertical, horizontal, & 
circular gauges with choice of 
needle or color bar as indicators 

• Linear & logarithmic scales 

Table 

- Column & row split windows 

- Multiple row & column selections 

- Check boxes/radio buttons/bitmaps/ 
editable/combobox column 

- Input validation 

- Color customization 

Status Bar 

- Auto scrolled text 

- Stretchable field width 

* Colored progress bar 

- Show date, time, & key states 


Source code for the 
Borland 3D Chart is available! 



Split windows 



Consulting & 

Contract Programming Available 


Free Demo from BBS. 

No Royalties. 30-day MBG. 
Optional with source code. 


Tel: (408) 263-9881 
Fax: (408) 263-9883 
BBS: (408) 263-0892 


Kansmen Corporation 
P.O. Box 360070 
Milpitas, California 95036 
USA 
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TM 


The Only 
Windows Tool 
That Lets Von 
Develop 



The Applicat-based language engine 
(a.b.l.e.) lets you use any Windows® 
command (even those embedded in 
other applications) to produce macros 
that cross new frontiers. 


Use DDE, OLE, API and more, in any 
combination. You get over 100 library 
and 500 API functions, too. And you 
get Macro WorkBench so you can build 
your own data base of commands. For 
more unique power at you fingertips. 


So much power, at a price you can’t pass 
up. The Complete Developer Edition is 
only $395. Or consider the Professional 
Edition for only $1,495- which adds 
utilities and the ability to compile your 
macros into royalty-free .EXE files. 


There is much more, contact us for 
details. 


With Applicat, you’re the conductor. 
Orchestrate a world of Windows® 
macros across multiple applications. 
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InControl Systems Inc. 

(214) 219-1334 
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Software Tools 



Using Windows NT Event 
Logging 

Paula Tomlinson 


After you build and ship your Windows application, inevitably, customers 
report problems. And, no matter how hard you worked to phrase those abort 
messages in plain English, you will get reports like "Urn, it said it couldn't get a 
file or something.' Wouldn't it be nice if there was a tool you could use to see 
what those error messages really said, and in what order they appeared? There 
is such a tool for Windows NT, the Event Viewer, and this article will show you 
how to use it. 

The Windows NT event logging mechanism is a useful tool that has unfortu¬ 
nately, been something of a well-kept secret due to poor and incomplete docu¬ 
mentation. The event log can not only help you monitor your program execu¬ 
tion during development, but also furnish crucial information to users of your 
Win32 applications in the field. The event log provides a mechanism whereby 
applications, device drivers, and the operating system can log useful informa¬ 
tion to a common location that administrators can access. The Event Viewer 
(eventvwr.exe) in the Program Manager's Administrative Tools group offers a 
standard means of viewing software and hardware event notifications, and the 
Win32 event log routines provide a standard interface for logging and reading 
events programmatically. 

The Windows NT event-logging API is quite complicated. Fortunately, 
though, the normal application or device driver need not understand or make 
use of every possible feature of NT event logging. Typically, you have to per¬ 
form only three basic tasks: 

• Use a tool called the message compiler to create a resource that describes 
each event your application might generate. 

• At install time, add information about your application (mainly, the path of 
the DLL that contains your message resource) to a particular location in the 
registry. 

• At runtime, use the Windows NT API functions RegisterEventSourceO, Re- 
portEventO, and DeregisterEventSourceO to log events. 

The Windows API provides a full set of functions for reading and operating on 
the event logs that get generated by your application, but these are mostly 
unnecessary, since NT's Event Viewer gives you the ability to view and clear 
event logs interactively. This article presents a reusable C++ class that handles 
most of the details of event logging for you. 


Paula Tomlinson received an Electrical Engineering degree from Colorado State Univer¬ 
sity. For the past six years she has developed various DOS, Windows, and Windows 
NT-based drivers and commercial applications for the HP ScanJet scanners, the HP 
LaserJet Fax, and the HP DeskJet printers. She is currently working on a book tenta¬ 
tively titled Writing Device Drivers for Windows NT. The opinions expressed in this arti¬ 
cle are hers alone and do not necessarily reflect the opinions of Hewlett-Packard. Send 
questions or correspondence to Paula via internet as paulat@vcd.hp.com. 
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What Is the Message Compiler? 

The Windows NT documentation contains scattered ref¬ 
erences to a 'message compiler,' to 'message tables,' and 
to 'message files,' but never actually documents what any 
of these things are. For example, chapter 51 of the SDK 
documentation, entitled 'Resources,' contains a table that 
lists the various types of predefined Windows resources 
and the chapters that describe them. However, it contains 
an entry for a resource called 'message-table entry' and 
only tells you to refer to 'your message-compiler docu¬ 
mentation.' What is 'your message compiler,' and where 
is its documentation? It turns out that the message com¬ 
piler is one of those Microsoft products that fell through 


the cracks and did not get properly documented. You can 
find some information in code samples that come with the 
Windows NT SDK (refer to the \q_a\samples\logging direc¬ 
tory on the Win32 SDK CD-ROM), and you can find some 
information in a help file called me.hip (located in the 
mstools\bin directory if you've installed the Win32 SDK, or 
the msvent\help directory if you've installed the 32-bit edi¬ 
tion of Visual C++). 

A message table is a new predefined Windows re¬ 
source (resource type 11) that contains 'messages,' which 
are the text descriptions for events that an application 
wants to log. Each message consists of an integer ID, a 
severity (used by the Event Viewer for filtering), a symbolic 
name, a language, and the text that describes that event. 

The message compiler defines its 
own unique syntax (described later) 
for constructing these messages. The 
message compiler produces a binary 
resource file that you can then com¬ 
pile into a .res file by using a re¬ 
source compiler statement of the 
form: 


TablelD MESSAGETABLE filename.bin 

The message compiler actually gener¬ 
ates a .rc file that contains the cor¬ 
rect statement to include the binary 
file that it generates. A message file 
is typically just a DLL that happens to 
contain a MESSAGETABLE resource. 

I see no reason why Microsoft 
could not have just used the resource 
compiler and a new resource type to 
accomplish the same task as the 
message compiler. This would have 
been a simpler design and would 
have helped publicize the existence 
of the event logging capabilities. But 
the message compiler is what we've 
got, so it's what we'll use. 

What Constitutes an Event? 

Obviously, if every application and 
operating system component logged 
every insignificant aspect of its exe¬ 
cution as an event, not only would 
there be a drain on precious disk 
space (this is Windows NT after all!), 
but the overhead would reduce over¬ 
all system performance. While there 
is nothing to prevent an application 
from abusing the event log in just 
such a way, there are some general 
guidelines for logging events. 

There are three basic types of 
events: information, warnings, and 
errors. The security service uses the 
additional event types of Success 


LANGUAGE 




-lint 


for C/C++ 

presents Bug # 569 


#include <iostream.h> 

#include <string.h> 


int main() 

{ 

char *sl, *s2; 


si = new char(128); 
s2 = new char(128); 
strcpy( si, "hello brave new 
strcpy( s2, "world" ); 
cout << s 1 << s2; 
return 0; 

> 

); 


This program compiles OK but has a fatal flaw so that on most machines and for 
most compilers it will not print what was intended. What is the programmer doing 
wrong? Call if you need a hint. Refer to Bug #569. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new's matched by your 
destructor delete's? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much. more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

Options Galore: A plethora of options for 
message suppression, message format, 
compiler dependencies, etc. All messages 
can be individually suppressed or enabled, 
both locally and globally. Numerous 
compilers/ libraries supported. Runs on 
MS-DOS (Optional built-in 386 DOS 
extender) and OS/2. 

PC-lint for C $139 
PC-lint for C/C++ $239 

PC-lint users: call for update pricing 
Unix and Mainframe programmers: 

call for pricing for FlexeLint. 


PA add 6 c /c sales tax. 


Giirnpel Software 

3207 Hogarth Lane, Collegeville. PA 19426 
CALL TODAY (610)584-4261 Or FAX (610)584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 
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0 Add subkey for 
your application 


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog 

/ I \ 

Application Security System 


YourAppName 


/ 


EventMessageFile TypesSupported 


Add this subkey with a 
value of 

EVENTLOG_ERROR_TYPE 

EVENTLOG_WARNING_TYPE 

EVENTLOG_INFORMATIONAL_TYPE 


Hfl Add subkey whose value 
1 — 1 is the path of your message file. 


Audit and Failure Audit, but normal 
applications can ignore these two. An 
information event is typically used to 
indicate the occurrence of an impor¬ 
tant activity, such as a service start¬ 
ing or a DDE client connecting to a 
DDE server. A warning event is used 
to indicate some kind of recoverable 
anomaly, such as low disk space or 
failure to load an optional module. 

An error event is used to report a 
non-recoverable problem, such as 
failure to locate an important data 
file. Standard information is associ¬ 
ated with each type of event, but you 
can also add event-specific informa¬ 
tion. Events can be further subdivided 
into categories. You can use the 
Event Viewer to filter by event type 
and event category, as well as event 
source (a name describing the mod¬ 
ule that logged the event). 

When deciding what events to log, realize that these 
events may pile up in the log file without anyone looking 
at them, unless something goes wrong with your applica¬ 
tion. That means you probably do not want to include a 
lot of informational trace information in a production ver¬ 
sion of your software. However, if your code contains as¬ 
sertion checking or abort messages, those would be good 
candidates for logging as events: you could then have the 
end user use the Event Viewer to give you an exact his¬ 
tory of what went wrong. 

Modifying the Registry 

Figure 1 shows the modifications your application 
should make to the registry at install time. Event log man¬ 
agement information is maintained in the HKEY_LOCAL_MA - 
CHINE\SYSTEM\CurrentControlSet\Services\EventLog key of the 
registry. This key contains three default subkeys: 'Applica¬ 
tion', 'Security', and 'System'. Each subkey represents a 
separate log file; if you look in \windows\system32\config, 
you should see files named secevent.evt, sysevent.evt, and 
appevent.evt, where the physical event log data is stored. 
Each log file subkey can contain unique source subkeys 
for each process or service that is submitting events to the 
event log. An application that wants to log events would 
first create a unique source subkey (typically based on the 


name of the application or a component of the applica¬ 
tion, such as DrWatson) under the "Application' logfile 
subkey. 

The application then adds two subkeys to its source 
subkey. The 'EventMessageFile' (type REG_EXPAND_SZj value 
specifies the complete path and filename of the associated 
message file (usually in the form of a resource-only DLL 


PINNACLE 

RELATIONAL 

ENGINE 

The Portable Compact Client-Server RDBMS 
For C/C++ Programmers 
DOS, Windows, UNIX, Mac, OS/2, NT, VMS 


Painless Database Programming! 


Listing 1 Entry code for resource-only DLL 


II eventmsg.c 
#include <windows.h> 

BOOL WINAPI DllMaintHANDLE hlnst, DWORD dwReason, LPVOID IpResrv) 
{ 

return TRUE; 

} 

/* End of File */ 


Vermont 

✓X Database 

Corporation 

1-800-822-4437 


Vermont Database Corporation / 400 Upper Hollow Hill Road 
Stowe, VT 05672 USA 
802-253-4437 / 802-253-4146 (FAX) 
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that contains event message information). The 'TypesSup- 
ported' (type REG_DhlORO) value is a bitmask specifying 
which event types this source supports (typically 
EVENTL0G_ERR0R_ TYPE / EVENTLOG_UARNING_ TYPE / EVENTLOGJN- 
FORMA TI0NAL_ TYPE). 


Listing 2 Example message table script 


MessageIdTypedef=DWORD 

Severi tyNames=(Success=0x0:SEVERITY_SUCCESS 

Informational=0x1:SEVERITY_INFORMATIONAL 
Warm' ng=0x2: SEVERITY_WARNING 
Error=0x3:SEVERITY_ERROR) 

MessageId=0xl 
Severity=Informational 
Faci1ity=Application 
SymbolicName=MSG_LOADSUCCESS 
Language=English 

The XI module was loaded successfully. 


Messageld=0x2 
Severity=Warning 
Facility=Application 
SymbolicName=MSG_LOWDISK$PACE 
Language=English 

Disk space on drive XI is getting low. 


Messageld=0x3 

Severity=Error 

Faci1ity=Application 

SymbolicName=MSG_CANTFINDFILE 

Language=English 

Could not locate file XI. 


If your application supports event categories, then you 
can also add the 'CategoryMessageFile' (type REG_EX- 
PAND_SZj and 'CategoryCount' (type REGJWORDi subkeys to 
specify the category message file and the total number of 
categories supported. In theory, supporting categories 
might be a good strategy for applications or services that 
provide a lot of complex event information. In practice, 
however, I've yet to find an application or service that 
supports categories. 

Creating a Message File 

What the NT SDK documentation calls a 'message file' 
is just a DLL that happens to contain a MESSAGETABLE 
resource. You may find it convenient to use a resource- 
only DLL for this purpose, in which case, you will follow 
these steps to create your message file: 

• Create a .me file that contains the script for the mes¬ 
sage compiler (syntax described later). 

• Compile the .me file with the message compiler to pro¬ 
duce one or more .bin files containing compiled mes¬ 
sages, a .re file containing MESSAGETABLE statements 
and references to the .bin files, and an include file con¬ 
taining message definitions. 

• Compile the .re file with the resource compiler to ob¬ 
tain a .res file. 

• Compile a stub DLL entry point function (see eventmsg.c 
in Listing 1) and link it with the .res file. 

The message file for the sample program I've included 
on the code disk is in eventmsg.mc (Listing 2). The message 
file should include a list of all messages that the source 
application may need to log (as I'll show later, in the 


Listing 3 Header generated by message compiler 


ll 

II Values are 32 bit values layed out as follows: 

II 

II 3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1 
// 10987654321098765432109876543210 

// + --+-+-+.+. . 

// |SevIC|R| Facility I Code 

// .-.---+. 

// 

// where 
II 

II Sev - is the severity code 
// 

// 00 - Success 

// 01 - Informational 

// 10 - Warning 

// 11 - Error 

II 

II C - is the Customer code flag 
// 

// R - is a reserved bit 
// 

// Facility - is the facility code 
II 

II Code - is the facility's status code 

II 

II 

II Define the facility codes 
II 


II 

// Define the severity codes 
// 


#define SEVERITYJARNING 0x2 
//define SEVERITY_SUCCESS 0x0 
//define SEVERITY_INFORMATIONAL 0x1 
#define SEVERITY_ERROR 0x3 


I // 

+ // Messageld: M$G_LOADSUCCESS 

II 

II MessageText: 

// 

// The XI module was loaded successfully. 

// 

//define MSGJOADSUCCESS ((DWORD)0x40000001L) 

II 

II Messageld: MSG_LOWDISKSPACE 
II 

II MessageText: 

// 

// Disk space on drive XI is getting low. 

II 

#define MSG_LOWDISKSPACE ((DWORD)0x80000002L) 

II 

// Messageld: MSGJANTF1NDFILE 
II 

II MessageText: 

II 

II Could not locate file XI. 

II 

//define MSGJANTFINDFILE (<DWORD)0xC0000003l) 

/* End of File */ 
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Object-Menu 

The easiest wav to create 
a first: tclass application 


object-Menu is a high-powered 
class-library that enables you to 
quickly create sophisticated object- 
oriented applications. Built-in aesthetics make it easy 
to create interface styling such as Windows, Motif, or your own custom 
design. Flexible interface configuration allows you to mold the interface to the 
application, not the other way around. Portability to DOS, Windows/NT and 
OS/2 allow you to offer your product to multiple target markets with a single 
engineering effort. And, object-Menu’s intuitive architecture, straightforward 
methodology and Visual Design Tool significantly speed GUI development to 
allow you more time to focus on the details of your application. 


single platform 

single platform w/source 

Professional 

(DOS & Windows, NT with source) 


it ED for Windows 
is a powerful, 
flexible tool for 
developers. 

—Larry Eiss, Director Application 
Development Strategy, Computer 
Associates Inf l, Inc. 



FEATURES: 

• Comprehensive set of interface 
and graphics objects including data 
entry, hypertext help and multi- 
media objects 

• Extensive “behind the scenes sup¬ 
port" keeps your programs small 
and easier to debug and maintain 

• Shortest learning curve 

• Includes Visual Design Tool with 
automatic code generation 

• Supports major C++ compilers and 
all popular DOS graphics libraries. 


-the programmer’s 
editor 


ED’s features are 
some of the most 
powerful PC Week 
Labs has seen in a 
Windows program¬ 
ming editor. w 

—PC Week, Aug 1992 


V 


f 


I 


ED-the programmer’s editor has 
all the features you need to expedite 
code development in both DOS and 
Windows. First, ED is smart about 
ming editor, yy f programming languages. There’s 
i ~pc Week, Aug 1992 custom color syntax highlighting, 

object matching, smart indent, comment 
alignment, code templates and code 
completion. And ED supports nearly 
every language/compiler (over 15 in all). ED can even spawn the compiler 
and track errors at the source. Plus, ED has loads of indispensible edit features 
such as block operations, multi-file search/replace with regular expressions, 
spell check, case conversion, line drawing and so much more. You’ll soar 
through start-up too! Built-in emulations and total customization capability 
make ED easy to leam and use. 



ED for Windows 
ED for DOS 

Professional Version 

(DOS & Windows) 


$249 
$ 199 
$349 



FEATURES: 


Emulations for BRIEF, Norton 
and more 

Supports Clipper, dBASE, C/C++, 
COBOL, FORTRAN and more 
Macros, key remapping, 
configurable toolbars 
Direct DBF file field access 
File differential analysis 
Can edit huge files 
hypertext function/procedure 
lookup 

Include file lookup 
On-line help including Windows^ 
SDK help 

Includes source code. 
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WriteCustomO method of the EventLog class, the application 
can also generate messages on the fly and log them as 
events). A message file has two sections, a header section 
and a message section. The header section defines values 
that are used in the message section. 

The header section contains the following keywords 
and values: 

MessageIdTypedef=[type] 

SeverityNames=(name=numbe r[:name]) 

Faci1ityNames=(name=number[:name]) 
LanguageNanies=(name=nuniber: filename) 

The MessageldTypedef value specifies the type casting that 
will be applied to message codes listed in the automat¬ 
ically created include file. Since the message code is a 32- 
bit value, I specified DWORD for this value. If the Mes¬ 
sageldTypedef keyword is omitted, the default behavior is 
for no type casting to be applied to message codes. 

The SeverityNames keyword allows you to list up to four 
severity codes (delimited by open and close parentheses) 
that can be used in the message section. The severity 
code includes a name, a two-bit numeric value, and an 
optional symbolic name. The severity code is stored in the 
high two bits of the automatically generated message 
code. If the SeverityNames keyword is omitted, the follow¬ 
ing default values are used: Success (0x0), Informational 
(0x1), Warning (0x2), and Error (0x3). I used the standard 
default values but added symbolic names for use in the 


message file; symbolic names are easier to remember and 
make the message file more readable. 

The FacilityNames keyword defines a list of valid facility 
names (delimited by open and close parentheses) that can 
be used in the message section. The list includes facility 
names, codes, and optional symbolic names. The facility 
code is stored in the low 12 bits of the high word (bits 16 
- 27) in the automatically generated (32-bit) message 
code. If the FacilityNames keyword is omitted, the default 
values are System (0x0FF) and Application (0xFFF). You can 
assign your own private facility codes, but the first 256 
codes are reserved for use by the Windows NT system. 
Since I only use the predefined Application facility in the 
sample eventmsg.mc (Listing 3) message file, I omitted the 
FacilityNames keyword all together. 

The LanguageNames keyword defines a list of valid lan¬ 
guage names (delimited by open and close parentheses) 
that can be specified in the message section. You specify 
the symbolic name for the language, the language ID 
(listed in winnt.h), and an arbitrary but unique file name 
for the automatically generated binary message file. Eng¬ 
lish is predefined and English messages are by default 
stored in a binary message file called mg@0001.bin. Since I 
only support English in this simple example, I omitted the 
LanguageNames keyword. To specify additional languages, 
use the IANG_ values listed in winnt.h for the language ID 
and specify unique binary message files (such as msg00002). 

The message section consists of a set of message defi¬ 
nitions of the following form: 



Do you need a 
bug tracking system 
that does more than 
just log problems? 

ControlFint does more: 

• Product structure supports versions, implementations and releases; 

• Tracks fixes including the module name(s) to be modified; 

• Allows you to link common problems together; 

• Provides complete history of all events; 

• SQL database provides flexibility and extensibility; 

• PVCS Interface for complete development environment. 

CALL 1-800-776-2176 for your FREE Demo Disk. 




REPOSITORY TECHNOLOGIES, INC. 

PVCS is a registered trademark of INTERSOLV, Inc. 


MessageID=[number|+number] 
Severity=serverity_name 
Faci1ity=faci1ity_name 
SymbolicName=name 
Languages anguagejiame 
textual message 


The MessagelD keyword marks the 
beginning of a new message, so it is 
a required keyword. However, the 
MessagelD value is optional. If no 
value is given, the previously used 
message value plus one will be as¬ 
signed. Alternatively, you can specify 
a '+n' format, which causes the mes¬ 
sage compiler to assign a value of n 
plus the previous message value. The 
MessagelD value cannot occupy more 
than 16 bits. In eventmsg.mc, I simply 
assigned sequential numbers, starting 
with 0x1, to each of my messages. 

The Severity and Facility key¬ 
words are optional. If they are omit¬ 
ted, they default to the last values 
specified. If no values had been 
specified previously, they default to 
'Severity=Success' and 'Facility=Ap- 
plication." The only valid names for 
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these keywords are the names listed 
in the Seven 4 tyNames and Facili tyNames 
keywords in the header section. In 
eventmsg.mc (Listing 2), I specified 'Ap¬ 
plication' for the facility in all cases. I 
added three messages to eventmsg.mc, 
one for each severity type. 

The SymbolicName keyword allows 
you to assign a convenient symbolic 
name for the message code. The 
symbolic name is defined in the 
automatically generated include file 
and thus can be used by any source 
file that incorporates that include file. 
My sample messages have the fol¬ 
lowing symbolic names: MSG_LOADSUC- 


Table 1 Message text format escape codes 

%0 

Terminates the message text line without adding a trailing newline. 

%% 

Generates a single percent sign in the formatted message text. 

%\ 

If occuring at the end of a line, generates a hard line break. 

%r 

Generates a hard carriage return without adding a trailing newline. 

%b 

Generates a space character in the formatted message text. 

%. 

Generates a single period character (as opposed to terminating the message). 

%! 

Generates a single exclamation point (as opposed to the string insert symbol). 

%n 

Specifies a string insertion, n can range from 1 to 99. This escape code can 
also be used to specify printf style format specifiers (refer to mc.hlp). 


CESS, MSG_LOUDISKSPACE, and MSG_CANTFINDFILE. 


until the event is viewed or read. This is because the cur¬ 


The next components of the message section are the 
Language statement and the body of the textual message 
itself. Messages are terminated by a line containing only a 
period and carriage return. To support more than one lan¬ 
guage, you list a Language and message pair for each 
language supported. The message text itself can contain 
white space and blank lines in addition to the special for¬ 
mat escape codes listed in Table 1. I embedded a single 
insertion string escape code (indicated by '%!') in each of 
the sample messages in eventmsg.mc. Remember that the 
language-specific version of the message is not chosen 


Listing 4 Resource compiler instructions 
generated by message compiler 


LANGUAGE 0x9,0x1 
1 11 MSG00001.bin 


Listing 5 Interface for EventLog class 


// EVENTLOG.H - Include file for EVENTLOG.CPP 
#ifndef _EVENTLOG_H_ 

VAdefine _EVENTLOG„H_ 

class EventLog 

{ 

public: 

EventLogfchar *szSourceName, char *szMessageDLL, 

BOOL bClearOnExit = FALSE, DWORD ‘dwStatus = NULL): 
virtual -EventLogO: 

DWORD BackuptLPTSTR szBackup); 

DWORD CleariLPTSTR szBackup); 

DWORD QueryiDWORD *dwNumRecords, DWORD *dw01destRecord); 

DWORD Read(DWORD dwRec, EVENTLOGRECORD *pData, DWORD dwSize); 
DWORD Write(DWORD dwEventID, WORD wEventType, WORD wStrings, 
LPCTSTR *psz$trings, DWORD dwData, LPBYTE lpData); 

DWORD WriteCustomiLPTSTR szString, WORD wEventType); 

private: 

char szSource[MAX_PATH]; 
char szRegKey[MAX_PATH]; 

BOOL bClearReg; 

// prevent copy by declaring without defining 
EventLogiconst EventLog&); 
const EventLogJ operator=(const EventLogA); 

}; 

#endif 


rent language is specific to the particular user logged on 
to the machine and thus can change. To allow for this, 
use only insertion strings for data fields, such as filenames 
and numeric values, rather than phrases. 

The message compiler automatically generates an in¬ 
clude file and a resource file with the same prefix as the 
message file. Since my message file is named eventmsg.mc, 
the message compiler generated eventmsg.h (Listing 3) and 
eventmsg.rc (Listing 4). eventmsg.h contains a fair number of 
inline comments, as well as a Mefine for each value I 
listed in the header section, and a ffdefine for each mes¬ 
sage listed in the message file. The message definition 
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also contains some helpful inline comments, including the 
text of the message (for the first language listed). 
eventmsg.rc (Listing 4) contains only a reference to the 
automatically generated binary file for each language. 
Since I only specified English, eventmsg. rc contains a LAN¬ 


GUAGE resource statement listing the language ID 
(LANG_ENGLISH is defined as 0x9) and sublanguage ID 
(SUBLANG_ENGLISHJJS is defined as 0x1) and a reference 
to the generated binary message file (msg00001.bin). 


Listing 6 Source code for EventLog class 


II EVENTLOG.CPP - Methods for EventLog class 
#include <windows.h> 

(/include "eventlog.h" 

#defi ne EVENT_APP "SYSTEMWCurrentControl SetWServi ces\ 
WEventLogWApplicationW" 

/** .... — . **/ 

EventLog::EventLog(char *szSourceName, char *szMessageDLL, 

BOOL bClearOnExit, DWORD ‘dwStatus) 

{ 

HKEY hKey; 

DWORD dwData; 

bClearReg = bClearOnExit; 
strcpytszSource, szSourceName); 

// just try creating it, if it exists, it will be opened 
strcpy(szRegKey, EVENT_APP); 
strcat(szRegKey, szSource); 

if (RegCreateKeyEx(HKEY_LOCAL_MACHINE, szRegKey, 0, "\0", 
REGJPTIONJONJOLATILE, KEY_ALL_ACCESS I KEY_WRITE, 

NULL, &hKey, &dwData) == ERROR_SUCCE$S) { 

// add the message file value 

strcpy(szRegKey, "%SystemRoot%\\System32\\”): 

strcattszRegKey, szMessageDLL); 

RegSetValueEx(hKey, "EventMessageFile", 0, REG_EXPAND_SZ, 

(LPBYTE)szRegKey, strlen(szRegKey)+l); 

// add the supported types value 
dwData = EVENTLOG_ERROR_TYPE I EVENTLOG_WARNING_TYPE I 
EVENTLOGJNFORMATIONJYPE; 

RegSetValueEx(hKey, "TypesSupported", 0, REG_DW0RD, 
(LPBYTEJ&dwData, sizeof(DWORD)): 

RegCloseKey(hKey); 

*dwStatus = TRUE; 

} 

else *dwStatus = FALSE; 

} // EventLog:;EventLog 

/**____**/ 

EventLog::—EventLog() 

{ 

HKEY hKey; 
if (bClearReg) { 

// caller specified for registry entry to be removed 
if (RegOpenKeyExCHKEY_LOCAL_MACHINE, EVENT_APP, 0, 
KEY_WRITE, AhKey) == ERRORJUCCESS) { 

RegDeleteKeythKey, szSource); 

RegCloseKey(hKey); 

} 

} 

} // EventLog;:~EventLog 

/**-----**/ 

DWORD EventLog::Backup(LPTSTR szBackup) 

{ 

HANDLE hSource; 

if ((hSource = OpenEventLog(NULL, szSource)) != NULL) { 
BackupEventLog(hSource, (LPCTSTR)szBackup); 
'loseEventLog(hSource); 

'Hi TRUE; 

‘urn FALSE; 
backup 


/** ... -**/ 

DWORD EventLog::Cl ear(LPTSTR szBackup) 

{ 

HANDLE hSource; 

if ((hSource = OpenEventLogtNULL, szSource)) != NULL) { 
ClearEventLogthSource, (LPCTSTR)szBackup); 
CloseEventLog(hSource); 
return TRUE; 

} else return FALSE; 

} // EventLog::Cl ear 

/**_---**/ 

DWORD EventLog::Query(DWORD *dwNumRecords, DWORD *dw01destRecord) 

{ 

HANDLE hSource; 

if ((hSource = OpenEventLogtNULL, szSource)) != NULL) { 
GetNumberOfEventLogRecordsthSource, dwNumRecords); 
Get01destEventLogRecord(hSource, dwOldestRecord): 
CloseEventLog(hSource); 
return TRUE; 

} else return FALSE; 

} // EventLog;;Query 

/**....**/ 

DWORD EventLog::Read(DWORD dwRec, EVENTLOGRECORD *pData, 

DWORD dwSize) 

{ 

HANDLE hSource; 

DWORD dwRead, dwRequired, dwStatus = TRUE; 

if ((hSource = OpenEventLogtNULL, szSource)) != NULL) 
return FALSE; 

if (!ReadEventLog(hSource, EVENTLOG_FORWARDS_READ I 
EVENTLOG_SEEK_READ, dwRec, pData, dwSize, AdwRead, 

SdwRequired)) dwStatus = dwRequired; 

CloseEventLog(hSource); 
return dwStatus; 

} // EventLog;:Read 

/**.....**/ 

DWORD EventLog::Write(DWORD dwEventID, WORD wEventType, 

WORD wStrings, LPCTSTR *pszStrings, DWORD dwData, 

LPBYTE 1pData) 

{ 

HANDLE hSource; 

if ((hSource = RegisterEventSource(NULL, szSource)) 1= NULL) { 
ReportEventthSource, wEventType, 0, dwEventID, NULL, 
wStrings, dwData, pszStrings, 1pData); 

DeregisterEventSourcethSource); 
return TRUE; 

) else return FALSE; 

} // EventLog::Write 

/** — ... __**/ 

DWORD EventLog::WriteCustom(LPTSTR pString, WORD wEventType) 

{ 

HANDLE hSource; 

if ((hSource = RegisterEventSourcetNULL, szSource)) != NULL) { 
ReportEventthSource, wEventType, 0, 0, NULL, 1, 0, 

(LPCTSTR *)&pString, NULL); 

DeregisterEventSource(hSource); 
return TRUE; 

} else return FALSE; 

} // EventLog::WriteCustom 
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Be careful when adding comments 
to the message file. The message 
compiler tries to carry these com¬ 
ments over to the generated include 
file and sometimes does not succeed 
in substituting the '//' comment spe¬ 
cifier correctly. If you add any inline 
comments to your message file, 
check the generated include file to 
ensure that the comments were 
transferred correctly. 

eventmsg.mak is included with the 
source distribution (see the table of 
contents for availability). It contains 
the basic information necessary for 
building a simple DLL plus a section 
for the message compiler. The only 
command-line argument required by 
the message compiler is the message 
filename: 

me eventmsg.mc 

The EventLog Class 


Figure 2 EVENTLOGRECORD structure 


typedef struct .EVENTLOGRECORD { 


DWORD 

Length; 

//length of event record (bytes) 

DWORD 

Reserved; 

//reserved 

DWORD 

RecordNumber; 

//use with ReadEventLog 

DWORD 

TimeGenerated; 

//time event submitted 

DWORD 

TimeWritten; 

//time event written to logfile 

DWORD 

EventID; 

//source-specific event ID 

WORD 

EventType; 

//error,warning,info (audit) 

WORD 

NumStrings; 

//number of strings in message 

WORD 

EventCategory; 

//source-specific subcategory 

WORD 

ReservedFlags; 

//reserved 

DWORD 

ClosingRecordNumber; 

//reserved 

DWORD 

StringOffset; 

//offset of Strings 

DWORD 

UserSidLength; 

//length of UserSid member 

DWORD 

UserSidOffset; 

//offset of UserSid 

DWORD 

Data Length; 

//length of event-specific Data 

DWORD 

DataOffset; 

//offset of event-specific Data 

// Then follow: 

// WCHAR SourceNameD 

//variable-length source name 

// WCHAR Computername[] 

//variable-length computer name 

// SID 

UserSid 

//security ID of active user 

// WCHAR Stringst] 

//message replacement strings 

// BYTE Data[] 

//data accompanying event 

// CHAR Pad[] 

//pad for DWORD alignment 

// DWORD Length; 

//length of event record (bytes) 

} EVENTLOGRECORD; 



I created a simple C++ class that 
encapsulates the event-logging rou¬ 
tines. The EventLog class is defined in eventlog.h (Listing 5) 
and the methods are implemented in event!og.cpp (Listing 
6). Five basic operations can be performed on the event 


log, and each is represented by a method in the EventLog 
class: Backup!), Clear!), Query(), ReadO, and UriteO. 

The EventLog constructor accepts several parameters. 
The first parameter is a string specifying the name of the 
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event-logging source. The source name is generally the 
name of the application (or module) that is logging events. 
This is merely a convention; you can specify any unique 
string as the source name. The second parameter is a 
string specifying the name of the message DLL. This DLL 
contains binary message information in its resources. The 
third parameter is a flag indicating whether the entries 
added to the registry should be deleted when the EventLog 
destructor is called. For testing purposes, you might want 
to pass a value of TRUE for this parameter, to avoid clutter¬ 
ing the registry with old source information. You can also, 
of course, delete any old information in the registry by 
using regedt32.exe. If you specify TRUE for this flag, be 
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aware that you will be able to view detailed event infor¬ 
mation only while the EventLog object is still allocated - 
once the object is destroyed and the registry entries are 
deleted, the Event Viewer can no longer find the associ¬ 
ated message DLL for any events that source had logged 
previously. The final parameter is a status value the cont- 
structor returns to indicate whether or not the tasks per¬ 
formed in the constructor succeeded. 

The EventLog constructor creates a new subkey, using 
the name passed as the szSourceName parameter, in the 
registry under the HKEY_LOCAL_MACHINE\SYSTEM\CurrentCon- 
trolSet\Services\EventLog\Application key. It then adds the 
'EventMessageFile' subkey with a value equal to the mes¬ 
sage DLL path. Note that I'm assuming the message file 
will be located in the %SystemRoot%\System32 directory. The 
constructor also adds a value for 'TypesSupported', speci¬ 
fying all three basic event types as supported by this 
source. The EventLog destructor deletes the source key 
added by the constructor if the bClearOnExit flag was TRUE. 
When a key is deleted from the registry, all subkeys and 
values underneath it are deleted as well. Note that when¬ 
ever you specify a string length in a registry function, you 
must include the null terminator. 

EventLog::BackupO uses BackupEventLogO to save the 
current contents of the Application log file to the filename 
passed in as a parameter. If the filename already exists, 
BackupEventLogO will not overwrite it. EventLog::Clear() de¬ 
letes the current Application log file. If you pass in a valid, 
unique filename to Cl ear O, the Application log file will be 
saved to that filename before it is cleared. By convention, 
saved log files have a .evt extension. Although I didn't 
provide a method to accomplish this, saved log files can 
be opened by calling OpenBackupEventLogO. Log files can 
also be restored by selecting 'Open...' from the Log menu 
in the Event Viewer. 

EventLog: :QueryO returns the total number of events 
currently in the Application log file and the record number 
of the oldest event in the Application log file. 
EventLog::Read() returns the requested event record in an 
EVENTLOGRECORD structure (see Figure 2). Notice that the 
EVENTLOGRECORD is followed immediately by several variable- 
length fields. These variable-length fields may contain 
padding at the end to ensure that subsequent fields are 
DUORD aligned. If the size of the buffer passed to 
EventLog: :Read() is not large enough to hold the entire re¬ 
cord, then EventLog::Read() returns the required buffer size 
back to the caller. You should call EventLog::QueryO before 
calling EventLog: :Read(), so that you'll know how many 
event records there are available to read in the Applica¬ 
tion log file. 

I provided both EventLog: :Urite() and 
EventLog: :UriteCustom() methods so that callers can easily 
log events based on message IDs or on message strings 
created on-the-fly, using ReportEventO. To log an event 
that is listed in the message DLL, you just pass the mes¬ 
sage ID and the event type ID to EventLog: :Urite(). You 
can also pass an array of insertion strings and an arbi¬ 
trary, event-specific buffer of data. If you want to log an 
event that is not listed in the message DLL, use 
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EventLog: :hlriteCustom(). EventLog::UriteCustom() passes 0 
for the message ID, indicating that the message is being 
passed in and is not contained in the message DLL. Al¬ 
though you can pass insertion strings and event-specific 
data even when not using a message from the message 
DLL, for simplicity I limited EventLog: :UriteCustom() to a sin¬ 
gle, preformatted string and did not allow inclusion of 
event-specific data. Notice that instead of opening and 
closing the event log (using OpenEventLogO and 
CloseEventLogO), as I did when reading, writing to the 
event log requires that I sandwich calls to ReportEventO 
between calls to RegisterEventSourceO 
and DeregisterEventSource()). 



Figure 4 Event Viewer after logging some events 


Using the EventLog Class 
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Event Detail 


Date: 3/29/94 
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Type: Warning 
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Figure 5 The Event Viewer detail dialog 
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top half of the dialog box is related to custom (on-the-fly) 
event messages. To log a custom event, type a message 
in the edit box, select the appropriate event type radio 
button, and press the Log Custom Event button. The dia¬ 
log procedure calls EventLog::MriteCustom() to log a custom 
event based on the information you specified. To view the 
event you've just logged, bring up the Event Viewer in the 
Administrative Tools group of the Program Manager. If the 
Event Viewer was already running, you may have to se¬ 
lect Refresh from the View menu to see the newly logged 
event. Also, to make sure you are viewing the Application 
log file, select Application under the Log menu. 

The Error, Information, and Warning buttons in the dia¬ 
log box call EventLog::Urite() to log an event based on a 
message ID in the message DLL. The sample message DLL 
I wrote (eventmsg.dll) contains an information message, a 
warning message, and an error message. Each message 
contains a placeholder for one insertion string. I hard¬ 
coded some insertion strings to pass to EventLog::Urite() 
in response to any of these three buttons being pushed. 
The sample warning message describes a low-disk mes¬ 
sage, so for demonstration purposes, I also pass a buffer 
of disk space information as event-specific data. This al¬ 
lows a user to view the event log at a later time and 
determine how much disk space was free when the warn¬ 
ing event was logged. Figure 4 shows the Event Viewer 
after three custom events and the three predefined events 
have been logged. Figure 5 shows the Event Viewer De¬ 
tails dialog box, with information for the predefined Warn¬ 
ing message. 

In response to the Read button being pushed, the sam¬ 
ple application first calls EventLog::Query() to determine 
how many records are currently stored in the Application 
log file. The code then reads the records one at a time, 
using EventLog: :Read(), and displays some of the informa¬ 
tion from the EVENTLOGRECORD structure in a message box. 

The Backup and Clear buttons call the corresponding 
methods in EventLog. For simplicity, I've hardcoded the log 
file names passed to EventLog:-.BackupO. This isn't gener¬ 
ally a good idea, since existing log files won't be overwrit¬ 
ten by subsequent calls to backup the log file. I pass a 
NULL as the filename for EventLog: :Clear(), indicating that I 
don't want the Application log file to be saved before 
clearing. 

Conclusion 

It's unfortunate that the event-logging facility and the 
message file format are not better documented. But if you 
can wade through the sparse documentation that does ex¬ 
ist and use this code as an example, I think you'll find the 
benefit of a consistent, uniform place for applications and 
services to log information well worth the extra work. The 
event log is not only useful during the development cycle 
but also extremely helpful in tracking down problems real 
customers may encounter in the field. 
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Driver Bug of the Month 

Paul Bonneau 


This month's driver bug occurs in a multimedia sound 
driver. In fact, the problem is not simply restricted to a 
single driver, but at the time of this writing, affects every 
single Windows sound driver ever created by Media Vi¬ 
sion. First, let me give you some background. 

Windows exports three levels of multimedia sound API 
functions. At the highest level is the single function 
sndPlaySoundO, which performs the bulk of what most pro¬ 
grammers require. It plays a ,nav file from either disk or 
memory, and gives you options to control the way the 
sound is played. Among these options are synchronous or 
asynchronous play. Synchronous means sndPlaySoundO 
does not return until the sound has finished playing; asyn¬ 
chronous means the function returns while the sound is 
still playing. You can also specify that sndPlaySoundO loop 
the contents of the given sound (better not do this in con¬ 
junction with the synchronous play option unless you re¬ 
ally want an infinite loop!). 

At the next level are the MCI commands. These com¬ 
mands give you a finer level of control over media play¬ 
back (and recording as well). The commands are analo¬ 
gous to the controls provided by an audio tape deck, and 
include start, stop, cue, pause, play, open, and close. 

At the lowest level are the 'wave' API functions. These 
give the programmer the greatest control over how sound 
is played, but af the expense of extra code that you have 
to write. It is at this level that the Media Vision sound 
drivers show their warts. 

The bug can best be explained in the context of an 
example. Let's say that you have this wonderful multime¬ 
dia application that plays the sound of a running motor as 


the user performs some function, say spell checking. The 
user presses the 'Begin' button on the spell-check dialog 
and hears the sound of a motor starting up. While the 
spell-check is in progress, the user hears the throbbing 
hum of the spell engine processing the text. When the 
process ends, the motor winds down to silence. So, there 
are three different sounds here (motor starting, motor run¬ 
ning, motor winding down), and you need to be able to 
loop the middle sound for however long the spelling 
checking is going on. 

You have to resort to the low-level sound API functions 
to cleanly play the above sound. You do it by queuing 
three different sound components. The head contains the 
sound of the motor starting and the tail contains the 
sound of the motor winding down. The body is the sound 
of the motor throbbing. Since the body will be playing for 
an indefinite amount of time, you need a sound that can 
be played in a loop. You want the start and end points of 
this sound to match, so that the sound is continuous at 
the loop point, otherwise the user will hear a discontinuity 
when the sound switches from "motor running" to 'motor 
winding down.' For a throbbing motor, you could have 
the body contain one cycle of 'throb.' Note that the end 
of the head and the start of the tail must also match the 
end point of the loop, so that the entire sound is played 
as a continuous stream. 

The way to do this is to queue the three sound compo¬ 
nents individually, using three calls to waveOutUriteO. This 
function accepts a sound buffer to play and a set of flags 
to control its play. The sound is placed in a queue, and as 
soon as one sound finishes, the driver removes the next 


July 1994 


Windows/DOS Developer’s Journal — Page 33 













from the head of the queue and plays it asynchronously. 
The flag UHDR_BEGINL00P specifies that a sound buffer is the 
first in a loop, and UHDR_ENDL00P specifies that it is the last. 
So with both flags specified for the body of the sound and 
neither for the head or tail, the driver is ready to play the 
desired sound. 

But the problem remains of how to terminate the body 
of the loop at the end of one of its cycles, rather than 
somewhere in the middle of a motor "throb.' You need to 
stop playing the body when the spelling check is com¬ 
plete, so that the tail can be played. And it is not accept¬ 
able to stop playing the body at some arbitrary position in 
the loop; it must happen at an end point for the sound to 


appear continuous. This functionality is provided by the 
function uaveOutBreakLoopO. It breaks out of a looping 
sound at the next upcoming loop point, rather than at its 
current point of execution. Unless the driver was written 
by Media Vision. In this case, if you are lucky, the sound 
breaks immediately, wherever it happens to be in the 
loop. Unfortunately, I know of no workaround for this 
bug. 

It gets worse. One particular Media Vision driver, the 
Pro Audio Spectrum, is noteworthy. After playing certain 
looping sounds, the driver will refuse to play any more. 
The only reliable workaround I have found is to follow all 
looping sounds with a "null" non-looping sound. By null 
sound I mean a short length of audio 
that is filled with neutral values (0's 
for 16-bit sound, 128's for 8-bit). 

What's still worse is that this 
driver will return success from 
uaveOutBreakLoopO, but continue to 
loop the sound. The only way to get 
it to stop playing a looping sound is 
to use the waveOutResetO function, 
which stops all sound and flushes the 
queue. This means you either have 
to add special case code for the 
driver (use uaveOutBreakLoopO for 
"good" drivers, and waveOutResetO for 
the Pro Audio Spectrum), or write 
code to detect that uaveOutBreakLoopO 
has not terminated the loop. Nor¬ 
mally, you would do this by checking 
to see if the driver has set the the 
UHDR_D0NE flag, which is what a driver 
typically does when it has finished 
playing a sound buffer. Unless, of 
course, it is the Pro Audio Spectrum. 
This driver will never set the bit, and 
if you are polling for it in a loop, 
your loop will never exit. 

My workaround is to use a multi- 
media timer. In my code that breaks 
out of a loop, I obtain the current 
time and call uaveOutBreakLoopO. The 
code then enters a polling loop look¬ 
ing for the UHDR_D0NE bit. If the bit 
gets set, then all is well and the loop 
exits. Otherwise, the loop again ob¬ 
tains the current time, and if the 
amount of time expired since the first 
call is greater then the duration of 
the loop, it calls uaveOutResetO to 
stop the sound dead in its tracks. 
This does not result in a pleasing 
sound for the user, but it's a lot bet¬ 
ter than hanging the machine. And 
besides, the poor user is probably ac¬ 
customed to the substandard perform¬ 
ance of his audio card anyway! □ 


Developers’ Toolkit Now Offered 


ISYS: The Editors’ Choice... 

For Text & Image Retrieval 

Leading computer publications consistently choose ISYS software as the preferred 
product in head-to-head reviews. They describe ISYS as the most user-friendly text- 
retrieval system available. Here’s what else they say: 

“ISYS for Windows is a winner !”... Infoworld “Hands-down \N\nm\” ...WordPerfectMagazine 
“ISYS... is a world-class package!”... PC Week “...the program to beat!”... PC Sources 

Now you can license the ISYS world-class engine for your applications. We’ve spent 
more than five years developing and refining a host of powerful features... so you don’t 
have to reinvent the wheel. ISYS gives you full text and image search and retrieval 
capability with features like these for your Windows, DOS or Pen applications. 


•Researches 2 billion words in one 
second—chains databases 

• Fast, sub-second response on 
word or phrase searches 

• Interfaces to over 30 popular 
file formats, including all 
major word processors, ASCII, 

ZIP, FoxPro and dBase 

•Very high level API 
•Automatically 
and transparently 
selects its own 
optimal retrieval 
strategy 
•Word, phrase, 

Boolean and 
proximity operators 
•Allows text access routines to 
be plugged into the bottom of 
the ISYS engine, providing full ISYS 
engine functionality for your own data 
sources, file formats—even distributed data 



Internally optimized, high-performance DLL 
•Wild cards and tense word stem searching 
•Searching within labelled paragraphs 
• Rule-based, or imperative-based, 
index building strategies 
Progressive searching 
•Sounds-like searching 
•Very low disk overhead 
(typically 20-25% of 
original text size) 
• Designed for ease 
of use by the 
calling programmer 
Searches up to 16 indexes 
at once—transparently 
•Builds an auxiliary index to 
the text in-situ—does not 
import text building strategies 
•Synonyms and dynamic synonyms 
• Ideal authoring software for CD-ROMs 
•Fast index building (typically 1 MB/minute) 
•Callable from C, Pascal, and even Visual Basic 



ISYS 

Text Retrieval Engine 


If you need powerful, full text and image search and retrieval capabilities, call and ask about 
the ISYS Developers’ Toolkit. You’ll be glad you did. 

Call 1-800-992-4797 
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ODYSSEY DEVELOPMENT 


650 South Cherry Street, Suite 430, Denver, CO 80222 
303-394-0091 or fax to: 303-394-0096 
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C CODE FOR THE PC 

source code, of course 

Graphic 7.0 (high-resolution, scientific plots in color & hardcopy, contour plots, device independence).$370 

TE Editor Developer’s Kit for Windows V 4.0 (full screen editor, undo command, word processing; TER for application build-in; no royalties) $300 
ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 
C/C+ -I- Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions. Jolt Award winner, specify C or C++)$250 

JUrboTrX (Release 3.1; HP, PS, dot drivers; CM fonts; LaTgX; MetaFont).$250 

Crusher! VZ00 (platform-independent data compression for network transfer; beats PK & LH on binary; directory trees; portable C) . . . . $215 

TE Editor Developer’s Kit Ver. 3.0 (full screen editor, undo command, multiple windows; with Word Processing $280).$190 

COMM-DRV (complete interrupt-driven serial communication libraries & device drivers; full source).$155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

XASM (cross assemblers & utility programs; 65xx, 68xx, Shot; Intel or Motorola hex format; macro preprocessor).$150 

Delorie GCC for MS-DOS (Version ZZZ includes C+ +, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 
Moby Crypto (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large integer packs, tutorials, more; not for export) . . $150 

Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs) .$140 

Ibrow (Version 4.1; programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$135 

SCM (portable Scheme in C, IEEE standard, includes JACAL symbolic math package; SCM-4D0/SLIB-1D5/JACAL-1A3) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

DA (disassembler for Microsoft’s New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).. $95 

Script Interpreter (a command script interpreter for DOS-based systems; C-fike script language; lots of features).$90 

CELT 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps; Unix code).$80 

CPPCOMM (C+ + serial communications class library for DOS, Windows, OS/Z and NT; includes X/Y/Zmodem).$75 

ET Neural Net (back error propagation and Kohonen).$75 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS Version 1.10 (Purdue Compiler Construction Tool Set; like YACC and LEX together with lots of additional features).$60 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C+-f).$50 

Container Lite V 1.82 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CLIPS Version 6.0 (rule-based expert system generator, Windows compatible; manuals on disk).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) .$50 

Editor Pack (20 public domain editors; micromacs 3.1Z Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised).$45 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export).$40 

Database Pack (9 databases-simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C++in C) .$35 

OCT (Object C Translator; essentially Brad Cox’s Objective-C Version 4) .$35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes Cand C++ grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

OORT (C++ray tracing code from the book by Nicholas Wilt) .$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags++, lots of .el files) .$25 

CTask Version 2.22d (robust MS-DOS multitasking kernel; C functions run as light-weight processes; mailboxes, interrupts, pipes, etc.) . . . $25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

FLEX Version 2.4.3 (fast lexical analyzer generator, new, improved LEX).$25 

GNU RCS (FSPs version of the Revision Control System; like Unix's SCCS only better, keeps track of software development).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, "common sense", concept related searches) .$500 

Wintertree Build-in Sentry Spell-Checker Library and ThesDB Thesaurus Library(CVC+ + API, no royalties, powerful).each $450 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, "common sense”, concept related searches) .$500 

Moby Pronunciator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,000 words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; 5.25” HD only).$35 

U. S. Cities (names & longitude/latitude of 3Z000 U.S. cities and 6,000 state boundary points).$35 

The World Digitized (100,000 longitude/latitude of world country boundaries).$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 

AI CD-ROM (expert systems, neural networks, genetic algorithms, fuzzy logic, linguistics/natural language).$105 

OmniMap (street-level US mapping; lots of topographical features, Windows viewer, output to many file formats).$75 

FontMaster II CD Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB) . . . $70 

Prime Time for Unix (Volume 3, No. 1, January, 1994; over 6GB of Unix C code).$60 

Walnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included).$50 

Wilnut Creek C User’s Group (Volumes 100 to 364).$40 

InfoMagic Unix (three public domain Unix systems: 386BSD, FreeBSD, and NetBSD).$40 

Updated! Linux/GNU/X by Yggdrasil Computing Version 1.1 (run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more).$35 

Mailer’s Lookup (9-digit ZIP codes by street address, distances between ZIP codes, phone locations; on-line tool, no source code).$35 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$35 

Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) .$35 

Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Walnut Creek X11R5 and GNU (X11R5 with contributed and comp.sourcesjt, over 120 GNU programs, complete C source).$35 

Walnut Creek Usenet and Simtel Unix-C (600MB).$35 

Walnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source).$35 

Austin Code Works Internet Warrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Thimpet, TCP/IP, FAQs, drivers, docs) . . . $35 

Walnut Creek FreeBSD (Berkeley 32-bit operating system for PCs; bootable).$35 

Walnut Creek Toolkit for Linux (Slackware distrubtion and complete Linux archive).$35 

Thins-Ameritech Slackware Linux (automated installation, lots of applications, extra kernels, Kanji, docs, FreeBSD).each $30 

Knowledge Media MegaMedia I and II (images, sounds, movies).each $30 

Whlnut Creek CICA Windows Archive (August 1993) .$20 

Whlnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$20 

The Austin Code Works much more ... ask for catalog Voice: (512) 258-0785 

11100 Leafwood Lane FAX: (512) 258-13f2 

Austin, Texas 78750-3587 USA http://www.clark.net/acw/home.html E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA/AMEX 
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CUSTOMIZE YOUR 
WINDOWS! 

For Experienced Programmers— 

GIVE WINDOWS YOUR OWN 
DISTINCTIVE LOOK. 


Custom Static Styles 



Custom Static Types 
flitmap 

Bitmap Stretch 
Bitmap Win. 
Frame 
Line Horz. 

Line Vert. 


Icon 
Icon Wind 
Rectangle 
Text 
Text Lowe 
Text Rais 
Text Shac 


Horizontal Alignment 
Left Center 


Vertical Alignment 

Top Center 

3D Appearance 

Border Lowered F 

Text Styles 
Expand Tabs 
Left No W.W 


Basic Styles 
Visible 
Disabled 


Group 
Tab Stop 



Extend the Windows API with your own 
components 

Build replacements for standard controls 

Create controls that handle huge amounts 
of text 


Learn how to 

• create a toolbox class 

• create a custom dialog class 

• interface custom controls to 

the Dialog editor 


WINDOWS 

CUSTOM 

CONTROLS 


WINDOWS 

CUSTOM 

CONTROLS 

William Smith 
Robert Ward 


This book includes all the code for a 
powerful set of ready-to-use custom 
controls. You can modify the code for 
your own design. 


Compiles under Microsoft C/C++, Quick 
C, and Borland C++ and has been 
tested under Windows 3.1 
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Technical 

Books 


Companion Disk for $29.95 

ORDER TODAY! 

Order: Book W99, Disk W99d, 
Book and Disk W99c 

913-841-1631 
FAX 913-841-2624 



VISA 


□ Request 338 on Reader Service Card □ 











































Using Custom Resources 

Charles Leamon 



Borland C++ v4.0 
Symantec C++ v6.1 
Visual C++ vl .5 



An area in which I spend all too much time is initializing dialogs. I looked 
around in the Windows API reference and found some very useful tools for 
automating this repetitive task - namely, custom resources! This article shows 
you how to use custom resources and presents some reusable functions that 
get your dialog box controls (listboxes, comboboxes, edit controls, and so on) 
automatically initialized with data. 

What Are Custom Resources? 

Windows resources are basically chunks of data compiled into a .res file 
and then tacked onto the end of your .exe by the resource compiler. Each 
resource is uniquely identified by a name and a type that you assign in your 
. rc file. Both the resource name and the resource type can be either strings or 
16-bit numbers; the Windows resource API functions all assume that if you 
supply a string pointer whose upper 16 bits are zero (a NULL selector), then the 
lower 16 bits contain a numerical ID. windows.h includes a macro called 
MAKEINTRESOURCEO which casts a 16-bit integer ID into a far string pointer for use 
with the API functions that accept a resource name or resource type string. 

Windows predefines several resource types, such as cursors, bitmaps, 
menus, dialogs, and so on. Each predefined resource type has a structure that 
is documented in the Windows SDK. The predefined resource types happen to 
be integer IDs that lie in the range 1 through 14, but Windows also reserves all 
resource type IDs from l through 255 for future expansion. You are free to 
define your own resource types that either have string IDs or have 16-bit nu¬ 
merical IDs that are greater than 255. 



Charles Leamon is a Senior Software Engineer at Pipeline Communications, Inc. of At¬ 
lanta, CA. He has 15 years of experience in the computer industry and has been pro¬ 
gramming Windows since Version 1. 
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Windows NT 
Considerations 

Resources are one of the areas where the 
Win32 API is not so compatible with Windows 
3.1. Win32 supports neither AccessResourceO nor 
SetResourceHandlerO, two of the more arcane 
functions in the Windows resource-handling API. 
On the other hand, Win32 gives you a new 
function, UpdateResourceO, which lets you add, 
delete, or replace a resource in a given .exe - a 
function that makes it much easier to create re¬ 
source editors for any custom resource you 
might create! 

Another Windows NT consideration is align¬ 
ment. Windows programmers are often suprised 
to discover that alignment of data may be a re¬ 
quirement, not just an optional efficiency en¬ 
hancer, on platforms other than the Intel 80x86. 
On a RISC machine, attempting to access an in¬ 
teger on an odd-byte boundary may well result 
in a hardware exception. Win32 guarantees 
that the beginning of your custom resource is 
aligned properly, but if your custom resource 
contains any embedded integers or floating¬ 
point numbers that you plan to access directly, 
you are responsible for inserting any padding 
bytes needed to make them align properly. 

Language support is the other big area 
where Win32 resources differ from Windows 
3.1 resources. Win32 resources can have a lan¬ 
guage and sublanguage code associated with 
them, so that you can compile a different copy 
of each resource for each language that you 
want to support. Win32 supplies a new func¬ 
tion, FindResourceExO, that lets you specify the 
language code when you search for a particular 
resource. Much of this is transparent for the 
standard resources (for example, DialogBoxO ob¬ 
tains the language currently in use and passes 
the correct code to FindResourceExO to obtain 
the correct dialog box for the current language). 
However, if you want a string in your custom 
resource definition to be interpreted as Unicode, 
you must prefix it with an 1': 

MyRes RCDATA 
BEGIN 

"An ANSI String\0", 

L”A Unicode String" 

END 

□ 


The resource compiler supports two very similar meth¬ 
ods for creating your own custom resources. One of the 
predefined resource types, RT_RCDATA (which is defined in 
windows.h to be resource type 10), is reserved for arbitrary 
custom resources, and the resource compiler supports a 
statement (the RCDATA statement) for defining custom re¬ 
sources of this type. An example RCDATA statement from a 
.rc file looks like this: 

Myld RCDATA 
BEGIN 

"String data\0", 

"in a list\0", 

11 /* or integers */ 

END 

The resource compiler also supports a user-defined re¬ 
source statement that looks like this: 

Myld MyResourceType 
BEGIN 

"Same syntax here", 

"as with RCDATA\0" 

END 

The user-defined resuurce statement syntax is almost the 
same as that for RCDATA except that you supply the 
name (or 16-bit ID greater than 255) for the resource in 
place of the keyword 'RCDATA'. The only other difference 
for the user-defined resource statement is that it allows 


Listing 1 Interface to dialog-populating routines 




* Listing 1 - populate.h 

* written by: Charles Leamon 

★★★★★★★★★★★★★★★★★★★★★★■AT****************************/ 


/**★*★★★****★★*★★**★*********★★★★*★*★★★***★★★*★**★★*★ 
* return codes 


★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■a ;**i 


enum { 

PDERRJOERROR, 

PDERR_CANTFINORES, 

PDERR_CANTLOADRES, 

PDERR_CANTLOCKRES, 

PDERR_CANTALLOCMEMORY. 

PDERR_CANTLOCKMEMORY 

}; 


* exported functions 

***************************************************i 

WORD PASCAL FAR _export 

PopulateDlgControlsCHWND hWnd. 

HINSTANCE hlnst, 

LPSTR IpszResource); 


WORD PASCAL FAR .export 
SetTextLimits(HWND hWnd, 

HINSTANCE hlnst, 
LPSTR IpszResource); 

/* End of File */ 
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you to specify that the custom resource consists of a sepa¬ 
rate file, like so: 

MyId MyResourceType filename.ext 

This form is a useful alternative if, for example, your cus¬ 
tom resource is a binary file generated by some other pro¬ 
gram. 

To load a custom resource, you first call FindResourceO 
to obtain a resource handle to the specific resource you 
want to load. If you defined your custom resource with 
the RCDATA statement, then you will need to pass FindRe¬ 
sourceO a resource type of RT_RCDATA, otherwise, you will 
pass the string or ID that you used in the user-defined 
resource statement of your .rc file. For example, to obtain 
a handle to an RCDATA custom resource, you might use: 

hRes = FindResourcethlnst, Myld, RT_RCDATA); 

whereas to load a user-defined custom resource, you 
might use: 

hRes = FindResourcethlnst, Myld, "MyResourceType"); 

After you obtain a resource handle by calling FindRe¬ 
sourceO, you can call LoadResourceO and LockResourceO to 
get the resource into memory and access it. You can also 
use the Windows API function SizeOfResourceO, given the 
handle returned by FindResourceO. You should not rely on 


Listing 2 Source for dialog-populating routines 


/★★★★★★★★★★★★★■A;************************************** 

* Listing 2 - populate.c 

* written by: Charles Leamon 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★j 

#include <windows.h> 

#include "populate.h" 


/**************************************************** 
* private function prototypes 

*************************************************** f 

static WORD PASCAL FAR 

ProcessResourcetHWND hWnd, 

VOID FAR *lp); 


static VOID PASCAL FAR 
AddString(HWND hWnd, 

WORD wCtrllD, 

LPSTR lpszString); 


static WORD PASCAL FAR 
GetCtrlTypetHWND hWnd): 


/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ft*************** 


* supported control types 


★★★★★★★★★★★★**************************************T*y 


struct tagCtrlType { 

WORD msg; /* message to 'settext' */ 

char *name; /* window class name */ 


} CtrlType[] = { 

LB_ADDSTRING, "listbox", 
CB_ADDSTRING, "combobox". 
WMJETTEXT, "static". 
WM_SETTEXT, "edit" , 
WMJETTEXT, "button" 


Lets Talk. 


Speech Systems, Inc. has ansxvered the demand for powerful, 
accurate speech recognition with its Phonetic Engine 9 500 
(PE500™), a state-of-the-art speech recognition system for 
Microsoft ® Windows™ applications. 


Talking 
To Your 
Computer 
Is No 
Longer 
A Dream 
ButA 
Reality 


The PE500 combines the features essential for de¬ 
veloping professional, speech-axvare applications: 

• Continuous Speech, which allows you to speak with¬ 
out pauses between words. 

• Speaker Independence, which lets you speak imme¬ 
diately xoithout training. 

• Large Active Vocabulary, which gives you more 
freedom when designing your application. 

• 40,000 Word Standard Dictionary, which you can 
expand with new words. 

PE500 System Development Kit (PE500 SDK) — 

$995. Includes the following: 

• Interactive Speech Card. 

• Softivare Development Tools for C, C++, and 
Visual Basic. 

• Noise-canceling microphone. 


To receive a copy of the white paper "How to 
Develop Speech-Aware Applications" or to 
order your copy of the PE500 SDK, please con¬ 
tact us at 303.938.1110,303.938.1874 (fax), or 
at 2945 Center Green Court South, Boulder, 
Colorado 80301. 



Speech Systems, Inc. 

Advanced Speech Recognition 
Solutions for Comjruters 
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the value returned by SizeOfResourceO for the exact size, 
though. This value can be, and most often is, slightly 
larger than the actual data, it's up to you to embed the 
actual size into the data or to be able to determine other¬ 
wise where the actual end of the data is. After you are 
finished using the custom resource, call FreeResourceO to 
free up the memory that it occupies. 


In general, if you are using custom resources that are 
binary data generated by some other program, you will 
probably want to use the user-defined resource statement 
to include them in your .rc file. On the other hand, if your 
custom resource is easily described by strings and integers, 
then there does not seem to be any compelling reason not 
to use the predefined RCDATA custom resource type. 


Listing 2 continued 


#define MAXJTRLTYPE \ 

(sizeof(CtrlType)/sizeof(CtrlType[0])) 

#define MAXSTR (1024) 

/**************************************************** 

* PopulateDlgControls - this is the entry point for 

* populating the dialog. It’s responsibilities are 

* to find, load and lock the specified resource. 

* It then delegates the remaining work to 

* ProcessResourceO, passing the dialog window 

* handle and a pointer to the locked resource. 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★it:*** j 

WORD PASCAL FAR _export PopulateDlgControls( 

HWND hWnd, /* dialog window handle */ 

HINSTANCE hlnst, /* inst handle for resource */ 

LPSTR IpszResource) /* RCDATA name */ 

/* (or MAKE INTRESOURCE(x)) */ 

{ 

WORD ret = PDERRJOERROR; 

HRSRC hRes; 
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Entering Custom Resource Data 

Generally, the documentation for custom resources is 
complete. Two items it does not cover, however, are how 
to include long integers and what escape sequences can 
be used in strings (when used in the resource script). To 
include a long integer, simply add the 'L' suffix. There are 
a number of special mappings for strings: 

• "\V is a single backslash 

• '\t' is equal to \011, the horizontal tab character 

• '\a' is equal to \010, the backspace character 

• "\x1 2" is hex byte 0x12 

• "\123" is octal byte 0123 or hex 0x53 

Initializing Dialogs with Custom Resources 

One of the more tedious tasks in programming dialogs 
is populating the various controls and setting text limits 
during UM_INITDIALOG message processing. I use many com- 
boboxes and listboxes to offer the user choices. The de¬ 
fault dialog class has no support for populating these con¬ 
trols automatically, so I find myself jumping among source 
files - //define'mg string IDs, creating string tables, calling 
LoadStringO/SendDlgltemMessageO, ad nauseam. 

Although some of the available application frameworks 
provide this automatic loading ability, the functions pre¬ 
sented here allow you to populate dialog controls with a 
single function call, and thus make it possible for you to 
spend more time working in other, more important sec¬ 
tions of code. All that's required beforehand is that you 
create a custom resource that contains the control ID 
(which you have to define anyway) and the strings to be 
added to the control. Here is an example of the sort of 
custom resource that you can use with these functions to 
initialize dialog boxes: 

SURVEY_DIALOG_SW RCDATA 
BEGIN 

CBB_AGE_GROUP,"under 18\0" 

CBB_AGE_GROUP,"between 18 & 30\0" 

CBB_AGE_GROUP,"over 30\0" 

LB_RAGS_READ,"Window/Dos\0" 

LB_RAGS_READ,"PC WEEK\0" 

... etc ... 

LBJiOBBIES,"Computing\0" 

LB_HOBBIES,”Biking\0" 

... etc ... 

TX_EXPLAIN,"blah, blah," 

"blah, blah\0" 


END 
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Note that you must explicitly supply the terminating 
NULL byte for the strings. The resource compiler will not do 
this for you. If you omit the NULL, the string will be contin¬ 
ued. This can be useful when you want to continue a 
string on another line - something that's not possible 
with a STRINGTABLE string. In this example, you must also 
add the 0,0 for the last entry. This 0 control ID is a senti¬ 
nel that marks the end of the data. 

The convention I've used for control IDs helps me iden¬ 
tify the type of ID - a sort of Hungarian notation for dia¬ 
log controls. In the above example, CBB_ is a combobox 
ID, LB_ is a listbox ID, and TX_ is a static text ID. In addi¬ 
tion, I use an RCDATA name that is often the same as the 
dialog's name, or that contains the dialog name. This al¬ 
lows me to create the resource name at run-time, like this: 

case WMJNITDIALOG: 

wspri ntf (szResourceNante, 

”SURVEY_DIALOG_%s", 

szVendorType); 

PopulateDlgControls(hWnd, 
hlnst, szResourceName); 


Of course, you may use any convention you wish. 

I've used this method to create common dialogs that 
load different data, based on run-time decisions. This obvi¬ 
ates the need for multiple dialog templates. Simply look at 
a profile string, and load away. 


Code Description 

popul ate. h (Listing 1) and popul ate. c (Listing 2) imple¬ 
ment the library functions Popul ateDl gControl s() and Set- 
TextLimitsO. These may be placed in a static link library 
or added to a DLL, depending on your needs. In this arti¬ 
cle, I'll simply link them with the sample program. (The 


Listing 2 continued 


VOID FAR *1 p; 

/* find, load and lock the resource */ 

hRes = FindResourcelhlnst,IpszResource.RT_RCDATA); 

if (hRes) { 

HGLOBAL hMem = LoadResourcethlnst, hRes); 
if (hMem) { 

lp = LockResource(hMem); 
if (lp) { 

ret = ProcessResource(hWnd, lp); 

UniockResource(hMem); 

) else ret = PDERR_CANTLOCKRE$; 
FreeResource(hMem); 

} else ret = PDERR_CANTLOADRE$; 

} else ret = PDERR_CANTFINDRES; 
return(ret); 


* SetTextLiraits - this is the entry point for setting 

* the text limit of a group of edit contols. 

*★★**★*★★******★**★*★***★*★★★★★★*★*★★★★★•*★★★★*★★★★★ j 

WORD PASCAL FAR .export SetTextLimits( 

HWND hWnd, /* dialog window handle */ 
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true value in software." — Thomas Murphy, 
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[full reprints available] 


Order now for just $159 

FREE GIFT IF YOU MENTION THIS AD 

Risk-free, 60-day money-back guarantee! 

To order, call UnderWare, Inc. 
today at 800-343-7308 

In MA or outside US, call (617) 267-9743 
or fax (617) 424-1839. 


□ Request 109 on Reader Service Card □ 


July 1994 


Windows/DOS Developer’s Journal — Page 41 

















sample program is included on the code disk - see 'On¬ 
line Source Code' on the contents page for availability.) 

PopulateDlgControlsO is the first of two exported func¬ 
tions in populate.c. You must pass the window handle of 
the dialog (or parent window), the instance handle of the 
module where the custom resource (the one that contains 
the initialization data) can be found, and the name of the 
custom resource. PopulateDlgControlsO then takes the re¬ 
sponsibility for finding, loading, and locking the specified 
resource. If the resource can't be found, loaded, or locked, 
an appropriate error code is returned. Otherwise, Populate- 
DlgControls calls ProcessResourceO to extract the data. 


ProcessResourceO takes two parameters: a window han¬ 
dle and a far pointer to the resource data. ProcessRe¬ 
sourceO begins by trying to allocate and lock a buffer for 
loading the strings. If this fails, the appropriate error value 
is returned to PopulateDlgControlsO, which in turn returns 
this value to its caller. If memory can be allocated and 
locked, ProcessResourceO then proceeds to walk the data. 
Since I decided to use variable-length strings, I have to 
scan each one to find the beginning of the next. Although 
this may seem like a lot of work, it only has to be done 
once: the benefit is smaller resources than using fixed- 
length strings would require. The algorithm for scanning is 
quite simple: 


Version 2 
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set a word pointer (wp) to the passed 
in buffer 

while the word at wp is not null 
{ 

copy bytes starting at 
wp+sizeof(WORD) until a NULL is found 
call AddString(() 

set wp to address of this NULL + 1 
} 

AddStringO requires three parame¬ 
ters: a window handle, a control ID, 
and a pointer to a string. AddStri ngO 
tries first to obtain a valid window 
handle for the control. AddStri ngO 
next calls GetCtrlTypeO to determine 
what message is to be used for set¬ 
ting the text, then sends a message 
to the control. If the window handle 
cannot be obtained, AddStri ngO sim¬ 
ply returns. 

GetCtrlTypeO uses its only parame¬ 
ter (the control window handle) to get 
a class name. It then looks up the class 
name in the CtrlType table. If it finds 
the name, GetCtrlTypeO returns the 
corresponding message value to 
AddStringO ; otherwise, it returns a zero 
to indicate an unsupported class. 

SetTextLimitsO is the second ex¬ 
ported function in populate.c (Listing 
2). As with PopulateDlgControlsO, you 
must pass the window handle of the 
dialog (or parent window), the in¬ 
stance handle of the module where 
the resource can be found, and the 
nam the resource. Since SetText¬ 
LimitsO has only to deal with one 
type of control and a pair of integers 
in the resource data, it is imple¬ 
mented in a single function. It is basi¬ 
cally identical to PopulateDlgCon¬ 
trolsO. SetTextLimitsO simply ex¬ 
tracts pairs of integers (control ID, limit) 
until a pair of zeros is found. For each 
non-zero pair, SetTextLimitsO sends 
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an EM_LIMITTEXT message to the window identified by the 
first integer, with wParam set to the value of the second 
integer. 

Conclusion 

Once you've learned how to use custom resources, 
you'll discover all sorts of applications for them. I've used 


them for CRC tables, compressed bitmaps, etc. Any type of 
static data (especially when it's large) that you need only 
on a temporary basis and that you want bound to your 
executable or DLL is a candidate for a custom resource. □ 


Listing 2 continued 


HINSTANCE hlnst, /* inst handle for resource */ 

if (wLen < MAXSTR) 

LPSTR IpszResource) /* RCDATA name */ 

/* copy the null too */ 

/* (or MAKEINTRESOURCE(x) ) */ 

*lpWork++ = *1pResString++; 

{ 

else { 

WORD ret = PDERR NOERROR; 

/* null terminate it here, then skip */ 

HRSRC hRes; 

/* the remainder so we point to the */ 

WORD FAR *wp; 

/* next Ctrl id */ 

/* find, load and lock the resource */ 

‘IpWork = 0; 

hRes * FindResourcethlnst,IpszResource,RT RCDATA); 

whi 1 e(*l pResString++) 

if (hRes) { 

/* empty loop */ 

HGLOBAL hMem * LoadResourceChlnst, hRes); 

; 

if (hMem) { 

} 

wp * (WORD FAR *)LockResource(hMem); 

AddStringthWnd, wCtrlID, IpszString); 

if (wp) { 

/* move word pointer to new position */ 

while(*wp) { 

wp = (WORD FAR *) 1pResString; 

SendDlgltemMessage(hWnd, *wp. 

) 

EMJ.IMITTEXT, *(wp+l), 0L); 

GlobalUniock(hMem); 

wp += 2; 

} else ret = PDERR CANTLOCKMEMORY; 

) 

GlobalFree(hMem); 

Uni ockResourceC hMem); 

} else ret = PDERR CANTALLOCMEMORY; 

} else ret » PDERR CANTLOCKRES; 

return(ret); 

FreeResource(hMem); 

1 

} else ret = PDERR CANTLOADRES; 


) else ret = PDERR CANTFINDRES; 

/**************************************************** 

return(ret); 

* AddString - Sends appropriate message to control 

) 

*************************************************** j 


static VOID PASCAL FAR AddString( 

! **************************************************** 

HWND hWnd, /* dialog window handle */ 

* ProcessResource - enumerates the resource, calling 

WORD wCtrlID, /* id of target control */ 

* AddString for each id/string pair found. 

LPSTR IpszString) /* string to set into Ctrl */ 

***************************************************/ 

{ 

static WORD PASCAL FAR ProcessResource! 

HWND hWndCtrl = GetDlgltem(hWnd, wCtrl ID); 

HWND hWnd, /* dialog window handle */ 

if (hWndCtrl) ( 

VOID FAR *1p) /* pointer to locked resource */ 

WORD msg « GetCtrlType(hWndCtrl); 

{ 

if (msg) { 

WORD ret = PDERR NOERROR; 

SendMessage(hWndCtrl, msg. 0. 

WORD FAR *wp; 

(LONG)lpszString); 

WORD wCtrllD; 

) 

WORD wLen; 

) 

HGLOBAL hMem; 

) 

LPSTR IpszString, 1pResString, IpWork; 



!**************************************************** 

hMem = GlobalAllocCGMEM MOVEABLE IGMEM ZEROINIT, MAXSTR+1); 

* GetCtrlType - determines class of window and what 

if (hMem) { 

* message should be used for setting the control's 

/* allocate a working buffer */ 

* text (ie. CB_ADD$TRING, WM SETTEXT) 

IpszString * ( LPSTR)G1obalLock(hMem) ; 

*************************************************** j 

if (IpszString) { 

static WORD PASCAL FAR GetCtrlType( 

/* if successfully allocated */ 

HWND hWnd) /* control window handle */ 

/* point to first Ctrl id */ 

{ 

wp = (WORD FAR *)lp; 

static char szClassName[40]; 

while(*wp) { 

WORD ret; 

/* walk the resource with pointer wp */ 


/* the WORD here is the control ID */ 

if (GetClassNameChWnd. szClassName, 

wCtrlID = ‘wp: 

sizeof(szClassName))) { 

/* set target ptr to start of buffer */ 

int which; 

IpWork ■ IpszString: 

for(which=0: which < MAX_CTRLTYPE; which++) { 

/* set source ptr at 1st byte after id */ 

if (1strcmpi(CtrlType[which].name. 

1pResString = (LPSTR)wp+sizeof(WORD); 

szClassName) == 0) { 

wLen = 0; 

ret = CtrlType[which].msg; 

/* copy bytes until a NULL is found */ 

break; 

/* or maximum length is reached */ 

) 

while(*lpResString && wLen < MAXSTR) { 

) 

*lpWork++ = *1pResString++; 

if (which == MAX_CTRLTYPE) ret = 0; 

wLen++; 

} else ret = 0; 

) 

return(ret); 


/* End of File */ 
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■ Practical C++ 



Ron Burk 


Windows Debugging Output 



This is the tenth in a series of columns about the design and implementa¬ 
tion of WUIMAN (a Windows User Interface MANager). This installment de¬ 
scribes the code WUIMAN uses for debugging output. 

The Problem with MessageBoxO 

When I first started tinkering with WUIMAN, I would just use MessageBoxO as 
a crude debugging output statement, to emit temporarily helpful information 
such as 'function AWuiObject::SetO invoked.' As WUIMAN got bigger and more 
complicated, MessageBoxO became too inconvenient to use. It does not accept 
printfO- style arguments, so I often had to use sprintf() into a temporary buff¬ 
er that I then passed to MessageBoxO. Also, you have to push a button to dis¬ 
miss the message box, which makes MessageBoxO too tedious when you want 
to quickly trace execution. 

Another problem with using MessageBoxO for debugging is more subtle. Sup¬ 
pose you are writing a C++ DLL that contains static objects that get con¬ 
structed. If, during debugging, those constructors call MessageBoxO, the call can 
fail if the calling application does not yet have a message queue (likely true if it 
linked implicitly with your DLL rather than calling LoadLibraryO). 

DebugOutputO 

The Windows 3.1 API includes a function called DebugOutputO that seems 
ideal for debugging output. The first argument is a flag that classifies this de¬ 
bugging statement as either a trace, warning, error, or fatal message. The re¬ 
maining arguments are those of printfO, a formatting string followed by a 
variable number of other arguments of various types. Like wsprintfO (on which 
this function presumably relies), DebugOutputO can't handle floating-point ar¬ 
guments, but that's fine for most of my applications. One nice thing about 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 72 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ront3@rdpub.com (“ . . . luunetirdpubironb”). 
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DebugOutputO is that, unlike lots of other possible ways of 
emitting a debugging message, it works correctly even if 
the current application has not finished initializing yet 
(doesn't have a message queue). 

Where does DebugOutputO output go? The online SDK 
documentation is not terribly helpful, saying only that the 
function 'sends a message to the debugging terminal.' As 
far as I can tell, when the debugging version of Windows 
starts up, it opens a file that it uses for debugging output, 
including strings sent to DebugOutputO. Windows obtains 
the name of the file it opens by looking in the [Debug] 
section of system.ini for the value of the "OutputTo=" 
string; if that entry does not exist, it opens AUX: (the auxil¬ 
iary port) by default. One interesting side-effect of this 
scheme is that if you have share.exe loaded and run the 
debugging version of Windows, any attempt to open the 
file (or device) named in the "OutputTo=" string will pro¬ 
duce a sharing violation (because Windows itself is keep¬ 
ing it open). 

Of course, the auxiliary port may not be where you 
want your output to appear. The DebugOutputO documen¬ 
tation does not tell you that calls to DebugOutputO result in 
a special operating system notification that programs can 
intercept by using tool help, dll's NotifyRegisterO function. 
That is how programs like Turbo Debugger for Windows, 
WinScope, and Microsoft's DBWIN manage to display out¬ 
put from the debugging version of Windows in a window. 

The Problems with DebugOutputO 

Unfortunately, DebugOutputO is not so simple to use. Try 
compiling and linking the following simple program: 

^include <windows.h> 

int PASCAL WinMain(HINSTANCE, 

HINSTANCE, LPSTR, 
int Command) { 

DebugOutput(DBF_TRACE, 

"WinMain invoked with command of %d”. 

Command); 
return 0; 

} 

I compiled and linked this code with Borland C++ v4.0, 
Symantec C++ v6.1, and Visual C++ vl.5. In all three 
cases, the compile worked fine but the linker com¬ 
plained that it could not find the symbol '_DebugOut- 
put' (DebugOutputO uses the 'cdecl' C calling sequence, so 
its link name is prefixed by an underscore). What's the 


problem? This is one of those cases where Microsoft could 
save many hours of wasted Windows programming time 
if they would just upload a corrected version of the online 
SDK help. It turns out that Microsoft - inexplicably - does 
not include the function DebugOutputO in the import library 
for Windows (1 ibu. 1 ib). 

DebugOutputO is exported correctly from the kernel, 
however, so you can fix this problem manually by adding 
an explicit import to your .def file, as follows: 

IMPORTS 

JebugOutput = KERNEL._DEBUGOUTPUT 

This resulted in a successful link with Microsoft and Sy¬ 
mantec, but the first time I tried it with Borland, even this 
didn't work! The answer took some investigation and 
some help from Matt Pietrek (author of Windows Internals). 

It turns out that Borland actually tries to remedy the 
Microsoft bug; instead of libw.lib, they supply an import 
library, called (unimaginatively) import.lib, which includes 
imports for Windows, as well as a variety of Windows li¬ 
braries that Microsoft treats separately (such as the Com¬ 
mon Dialog DLL). Borland helpfully includes an import re¬ 
cord for DebugOutputO in import, lib, so theoretically you 
should not have to add an explicit IMPORT statement to 
your .def file in order to access DebugOutputO. Unfortu¬ 
nately, DebugOutputO is a C function (in the C calling se¬ 
quence, case is significant), but Borland's import.lib names 
the function "_DEBUGOUTPUT" (all uppercase). You could 
manage to link via this import record, but you would have 
to do contortions like these: 

#include <windows.h> 
extern "C" { 

void FAR _cdecl DEBUGOUTPUT 
(UINT flags, LPCSTR lpsz, ...); 

}; 

int PASCAL WinMain(HINSTANCE, 

HINSTANCE, LPSTR, int Command) 

{ 

DEBUGOUTPUT(DBF_TRACE, 

"WinMain invoked with command of %d", 

Command); 
return 0; 

} 



Listing 1 dbtrace.h — Definitions for debugging 
output 


// provide separate debugging output 

void DebugPrintf(char Flag, const char ‘Format, ...); 

void DebugPrintf(const char ‘Format, ...): 

fdefine DEBUG_MORE DebugPrintf 
^define DEBUGJRACE DebugPrintft’t’. \ 

"%-12s %04d ", _FILE_ _LINE_), DebugPrlntf 

#define DEBUGJARNING DebugPrintft V, \ 

12s %04d ", _FILE__LINE_), DebugPrintf 

#def1ne DEBUG_ERROR DebugPrintft’e’, \ 

"*-12s %04d ", _FILE_, _LINE_), DebugPrintf 

#define DEBUG_FATAL DebugPrintf(’f’, \ 

"%-12s %04d ", _FILE_ _LINE_), DebugPrintf 

/* End of File */ 


Listing 2 dbtrace.c — Functions to implement 
debugging output 


^Include <stdarg.h> 

^include <std1o.h> 
ffinclude <string.h> 

#include <windows.h> 

#include "dbtrace.h" 

// static variable to remember most recent message type 
// (tacky, but effective) 

static char MessageType = ’t’; 


Emacs for Windows 


WinEmacs is a fully functional Windows 3.1 
version of the industry standard program editor 
Gnu Emacs, version 19.6. 


WinEmacs has these extended features 


• Separate buffers in different windows 

• Menu and drop-down menu bar 

• Multiple font size and type support 

• Cut and paste mouse support 

• Support for Text and Binary files 

• Clipboard support 

• Binds any arbitrary combination of key and 
key modifers to Emacs Lisp code 

Contact Pearl Software at pearlsoft.com (e-mail), 
510-652-4361 (voice) or 510-652-4362 (fax) for more 
information. Supported version costs $199. 


Call 1-800-WIN-EMACS 

We also provide EMACS consulting services. 

Pearl Software Corporation 

2000 Powell Street #1200, Emeryville, CA 94608 


Perhaps Borland generated import.lib mechanically and 
did not realize that 'cdecl' functions raise this problem 
with case sensitivity. One last note about Borland: I still 
could not get DebugOutputO to link with Borland C++ v4.0: 
the problem was that you have to use TLINK's VC' option 
(case sensitive exports and imports) if you want the ex¬ 
plicit import shown earlier to work. 

In the end, I gave up on using DebugOutputO. The main 
problem was that it is disabled in the retail version of 
Windows, and I reached a point where I did not want to 
always have the debugging version of Windows loaded 
just to get trace output from WUIMAN. A second minor 
problem was the weird fact that that trace messages (as 
opposed to warnings, errors, and fatal messages) don't 


Listing 2 continued 


void DebugPri ntf (char Type, const char *Format, vajist Args) 

{ 

char ‘Message = "No memory for DebugPrintf0.\r\r\n"; 

char ‘Buffer = new char[1000]; 

if(Buffer) 

{ 

char ‘Append = Buffer; 
sprintf(Buffer, "%c ", Type); 

Append = Buffer + strlen(Buffer); 
vsprintf(Append, Format, Args); 

Message = Buffer; 

} 

if(Message[strlen(Message)-1] == ’\n’) 

Messagefstrlen(Message)-1] = '\0*; 

OutputDebugString(Message); 
if(Type == ’\0’) 

OutputDebugString("\r\n"); 
if(Type == ’\0’ && MessageType == V) 

{ 

// So BoundsChecker will give stack traceback 
GlobalLock(0); 

FatalAppExit(0, Message); 

) 

if(Buffer) 

delete[] Buffer; 

} 

void DebugPrintf(const char ‘Format, ...) 

{ 

vajist Args; 
va_start(Args, Format); 

DebugPrintf(’\0’, Format, Args); 
va_end(Args); 

} 

void DebugPrlntftchar Type, const char ‘Format, ...) 

{ 

vajist Args; 
va_start(Args, Format); 

MessageType = Type; 

DebugPrintf(Type, Format, Args); 
va_end(Args); 

) 

/* End of File */ 
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seem to work. To be specific, consider the following func¬ 
tion calls: 

DebugOutput(DBF_TRACE, "trace"); 

DebugOutput(DBF_ERROR, "error"); 

DebugOutput(DBF_WARNING, "warning”); 

DebugOutput(DBF_FATAL, "fatal"); 

When I executed this series of calls, only three messages 
appeared in DBWIN (or WinScope, or any other notifica¬ 
tion logger I used) - the call using 
0BF_TRACE produced no output. I 
never did figure out whether this 
was a bug or an undocumented 
feature of Windows or if some¬ 
thing else was going on. in any 
case, I decided that DebugOutputO 
was not for me. 

OutputDebugStringO 

The main feature that I wanted 
from DebugOutputO was the ability 
to display my debugging messages 
in a window somewhere, even if 
they were emitted from the con¬ 
structor of a static object in a DLL. 

Another function in the Windows 
API, OutputDebugStringO, provides 
that capability, but it has the ad¬ 
vantage that it works with both 
the debugging and the retail ver¬ 
sions of Windows. It is similar to 
DebugOutputO in that it results in a 
debugging event that can be 
snagged via tool help, dll's Noti- 
fyRegisterO, so tools like DBWIN 
and WinScope can display the 
strings you pass to OutputDebug¬ 
StringO. OutputDebugStringO does 
not, however, accept printfO- style 
arguments, so i created my own 
wrappers for it that did. 

In WUIMAN, i divide debugging 
output messages into the same 
four categories that DebugOutputO 
uses: trace, warning, error, and fa¬ 
tal. Using traditional C tricks, I 
made four macros that conspire to 
produce the four different kinds of 
debugging messages, each of 
which includes the source filename 
and line number that generated 
the message, dbtrace.h (Listing 1) 
shows these macros, which use 
the preprocessor macros _FILE_ 

and_ LINE_ to obtain the source 

filename and line number. The 
macros use two underlying 


functions (both named DebugPrintfO) to do the real work. 

dbtrace.c (Listing 2) contains the two functions that the 
macros call to produce output. As is often the case when 
dealing with macros, some less-than-elegant constructs are 
involved here. The problem is that I want a macro like 
DEBUG_TRACE() to pass both some fixed data (the filename 
and line number) as well as a variable number of argu¬ 
ments that the macro user supplies. The C++ preproces¬ 
sor does not support constructs for handling a variable 


IMp Magicim Pro &Q 

The Professional Help Authoring 
Tool That Everyone Can Use! 

Beginners Love It 
Because It’s So Easy. 


With Help Magician Pro 3.0, 
you can develop online help and 
documents seamlessly in a true 
WYSIWYG environment much 
like WinHelp. If you have 
manuals or documents, Help 
Magician Pro will import them 
from any popular Windows 
word processor and convert 
them to online help. You can 
simultaneously test your help 
files while working on them. 


Experts Love It 
Because It’s So Powerful. 

Help Magician Pro has all the 
flexibility you’ve come to expect 
from a professional help 
authoring tool like support for 
ALL WinHelp 3.1 features,' a 
fool-proof macro editor, 
multi-file project management, 
multimedia support, automatic 
glossary creation, and much 
more. 



Actual Editing Environment 

Here’s The Scoop. 

The Help Magician is a proven 
product with years of customer 
support and satisfaction. We can 
demonstrate that the Help 
Magician Pro has more features 
and is faster and easier to use 
than any other help authoring 
tool. Drop us a line at 
1-800-542-2742 to get more 
details and a FREE fully 
functional demo disk. The Help 
Magician Pro now includes the 
Help Compiler and SHED editor. 


Order your copy of the Help Magician Pro 3.0 today. Only $249! 
30-day satisfaction money-back guarantee. 

Corporate site and network licensing available. 


p~ T .4 says "Designing help 
U L systems is so easy that 
S. L you might even want to 
SOI use it as a hvnertext 


use it as a hypertext 
authoring tool. Certainly for 
Windows programmers it’s 
indispensable." 


Oil Software 
Mil Interphase 
IV11 Incorporated 

82 Cucumber Hill Rd, #213 
Foster, Rl 02825 
Voice: (401) 397-2340 
Fax: (401)397-6814 
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File Edit Options Help 


t wuiobjdb.c 
t wuiobjdb.c 
{ wuiobjdb.c 
l wuimaac 
l wuimanc 
t wuiman.c 
l wuiman.c 
t wuiobjdb.c 
t wuiobjdb.c 
t wuimaac 
t wuimanc 
t wuiobjdb.c 
t wuimaac 


0597 TWuiRegisterf’T Container") 

0597 TWuiR egisterj' 1Attributel nt‘') 

0597 TWuiR egisterf' TAttributes tring''] 

0108 WUIMAN_Open(). This version of WUIMAN compiled with Borland C++. WUIMAN_ERR0RS»-2147483542 
0113 »WUIMAN_Open(lnstance, lniFileName='test.wui') 

0133 «WUIMAN_Open returns [1] 

0034 > > WUIM AN_G et(Path=7'Attribute»'p_W uimanV ersion') 

0175 [AWuiO bject:: G et][/] AbsPath = 7, RelPath = 7 Attribute='p_WuimanVersion' 

0175 [TWuiBaseAttribute::Get][p WuimanVersion] AbsPath * 7, RelPath = 7 Attribute='p_WuimanVersion' 

0054 «WUIMAN Get returns [3l"0.0'‘ 

0034 »WUIMAN_Get(Path=7^ttribute='m Child') 

0175 [AWuiObject::Get][/]AbsPath = 7. ReTPath = 7 Attribute='m Child' 

0054 «WUIMAN Get returns [1) "<NULL>" 


Figure 1 DBWIN output during WUIMAN session 


Rev Up Database 
Programming 

with Greenleaf Database Library 



Powerful Functions 


□ The SoftC Database Library 
is now the new Greenleaf 
Database Library. 

□ Unsurpassed speed and 
flexibility for access to 
industry standard database 
data, index, and memo files 
at an affordable price. 

□ Databased Advisor says, 

"SoftC Database Library has 
top ratings!" 

□ Don't be fooled by pretty 
ads—the Database Library is 
all you need to interface 
with dBASE III, dBASE IV, 
FoxPro, FoxBASE, Clipper, 
dBXL, and other xBASE files 
including new FoxPro CDX 
index files. 

□ Supports MS-DOS, 
Windows™, and is portable 
to OS/2, UNIX. 

□ Includes Windows 3.1 DLL, 
supports Microsoft, Borland 
and Zortech C/C++. 

□ Single and Multiple User; 
Network acccess fully 
supported. 

□ Database package not 
required—this product is a 
complete ISAM library. 

□ Windows DLL linkable with 
most DLL-capable compilers 

^includin^VisualBasic/^^ 


All Greenleaf Libraries Feature: 

□ No royalties 

□ 90-day money-back guarantee 

□ FREE unshrouded source (ANSI & K&R) 

□ FREE unlimited tech support 

□ Top rated documentation AND online 
documentation with FREE help engine! 

□ FREE BBS access, quarterly newsletter 

□ GOLD support available: toll-free access to 
BBS, tech support and free updates—call for 
prices 

Database Library v3.22 .. $249 

Call today for complete infor¬ 
mation, demo, or to order. Mas¬ 
terCard, VISA, AmEx, approved 
purchase orders. 

1 - 800 - 523-9830 

214-248-2561 
FAX 214-248-7830 
BBS 214-250-3778 

Greenleaf Software, Inc. 

16479 Dallas Parkway, Suite 570 
Dallas, TX 75248 

m 

GREENLEAF 
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number of macro arguments, so you 
can't do something like this: 

// theoretical syntax, doesn’t work! 
#define DEBUG_TRACE(...) \ 

DebugPrintf (_FILE_LINE_); 

Since I can't do that, my macro defi¬ 
nition instead expands into one call, 
followed by just a function name. 
The text that follows the macro invo¬ 
cation (presumably function argu¬ 
ments enclosed in parentheses) sup¬ 
plies the arguments for that second 
function call. 

Unfortunately, I resort to more 
trickery inside of dbtrace.c (Listing 2). 
Each macro invocation results in two 
calls to DebugPrintfO, and the first 
call establishes the category of mes¬ 
sage. In the case of a fatal message, I 
want to abort the program, which 
means that the second call must 
know that the first call was for a fatal 
message. I just use a static variable 
to accomplish this, which is wonder¬ 
fully non-reentrant, but has been 
good enough for my purposes to 
date. Figure 1 shows what the debug¬ 
ging output looks like when I use 
DBWIN to monitor the messages. 

Summary 

The Bug++ of the Month has 
been a regular feature of this col¬ 
umn, but we are moving our cover¬ 
age of bugs into separate features, so 
it will no longer appear here. If you 
have uncovered a nasty bug in Win¬ 
dows 3.1, Windows NT, a Windows 
device driver, or the latest version of 
Borland, Microsoft, or Symantec C++, 
write it up and send it our way, 
along with your workaround, if any. 
We'll trade you a free W/DDJ t-shirt 
for any bugs that we use in the 
magazine. 

This month's code disk has the 
complete WUIMAN source for the 
project to date, including code from 
past issues. The code displayed in 
this column actually resides in 
wuistd.h and uuistd.c in the WUIMAN 
source archive; I just broke it out 
into separate files for discussion 
here. The code disk is widely avail¬ 
able via sources listed in the table 
of contents. □ 
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TNT DOS-Extender v6.1 

Guy Eddon 


DOS extenders allow programmers to create DOS appli¬ 
cations that break the 640Kb boundary and take advan¬ 
tage of the extended-memory architecture of 80286 or 
better CPUs. Windows itself can be used as a DOS exten¬ 
der with a graphical user interface. Like Windows, DOS 
extenders load and run your program in protected mode; 
they must intercept a variety of program actions (such as 
calls to DOS or attempts to access video memory) and, for 
each requested action, switch back to real mode, execute 
the desired action, and copy any results back to protected- 
mode memory. The first generation of DOS extenders sim¬ 
ply allowed access to 80286 extended memory. The next 
major wave allowed DOS-extended programs to run in 
DOS boxes under Windows 3.1. This article looks at the 
latest innovation in DOS extenders: Phar Lap's TNT DOS- 
Extender, which allows you to create a single executable 
that runs under DOS, in a Windows 3.1 DOS box, or as a 
Windows NT console application. 

TNT Features 

TNT DOS-Extender offers your application more than 
just the standard C and DOS library functions; it provides 
a subset of the capabilities of Windows NT. When your 
TNT application runs under Windows NT, those capabili¬ 
ties are implemented by calling the operating system. 
When your TNT application runs under Windows 3.1 or 
DOS, those capabilities are implemented by the TNT ker¬ 
nel. (TNT, by the way, is said to represent Totally New 
Technology.) 

TNT provides the ability to create DLLs (Dynamic Link 
Libraries) and multithreaded/multitasking applications via 
a subset of the Win32 API. The multitasking/multithread¬ 
ing features provided by TNT are truly preemptive, which 
means an application might have one thread waiting for 
keystrokes, another saving data to a file, while yet an¬ 
other is receiving data from a modem. Phar Lap is also 
moving away from its proprietary EXP (Protected Mode Ex¬ 
ecutable) format to the industry standard PE (Portable Ex¬ 
ecutable) format used in Windows NT. As a result, TNT 


Product Information 


TNT DOS-Extender v6.1 

Phar Lap Software, Inc. 

60 Aberdeen Avenue 
Cambridge, MA 02138 
Voice: (617)661-1510 
Fax: (617)876-2972 
BBS: (617)661-1009 

email: dox@pharlap.com, tech-support@pharlap.com 


Price: $495 

Royalties: To redistribute your TNT application you 
must purchase the TNT DOS-Extender Run-Time Kit. 

Support policy: Phone, FAX, BBS, or e-mail. 

Update policy: From version 6.0, the update price is 
$100. From version 5.0, the update price is $200. 

Hardware: 80386 or better CPU. 

Summary: A DOS extender that allows you to create a 
single executable that works with DOS, Windows 3.1, 
and Windows NT. TNT DOS-Extender supports a subset 
of the Windows NT API, allowing your application to 
take advantage of DLLs, multiprocessing, and mul¬ 
tithreading, even under Windows 3.1 or DOS. Version 
6.1 of the product provides a "pipe' VxD that lets you 
write a Visual Basic program that serves as a GUI front- 
end for your TNT application. 


Guy R. Eddon is president of Guy Communications, Inc., a consulting firm specializing in Client/server systems. Guy also teaches 
Windows NT courses for Learning Group International. He can be reached on CompuServe at 71172,1014. 









Listing 1 parent.c — Code to spawn child process 


#include <windows.h> 

#include <stdlib.h> 

#include <$tdio.h> 

char chi1d[256] = "CHILD.EXE"; 

main!) 

{ 

STARTUPINFO si = { 0 }: 

PROCESSJNFORMATION pi = { 0 ); 
int i: 

CreateProcesstNULL. child, NULL. NULL. TRUE, 

NORMAL_PRIORITY_CLASS, NULL. NULL. &si. &pi); 
for(i = 0; i < 2000; i++) 
printfC'P"); 

} 

/* End of File */ 


Listing 2 child.c — Demonstration child process 


#inciude <stdio.h> 

main!) 

{ 

int i; 

forti = 0; i < 2000; i++) 
printfC'C"); 

} 

/* End of File */ 


applications which use the recommended PE format can 
be executed not only in DOS, but also as native Win32 
applications in Windows NT. A native application is one 
that does not run through any translation layer, such as a 
VDM (Virtual DOS Machine), but rather executes directly in 
the Win32 subsystem. Support for the Win32 API is a sub¬ 
set limited to system programming features. Figure 1 
(page 58) lists the Win32 functions supported by TNT. 

Process Management 

TNT applications can call the Win32 functions 
CreateProcessO and CreateThreadO to launch other proc¬ 
esses or to create additional threads of execution in exist¬ 
ing processes. To better understand how multiple proc¬ 
esses execute concurrently under DOS, I created an exam¬ 
ple which consists of two programs: parent.c (Listing 1) 
and child.c (Listing 2). The example illustrates the ability 
of one TNT application to launch others that execute con¬ 
currently, even under DOS or a Windows 3.1 DOS shell. 
Each of the two programs is a standalone protected-mode 
application. When run, the parent program calls 
CreateProcessO to launch the child program. At this point 
both processes are executing concurrently, with the parent 
program printing Ps, and the child program printing Cs. 
Under DOS the output resembled the following: 

PPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPP 

PPPPPPPPPPPPCCCCCCCCCCCCCCCCCC 

CCCCCCCCCCCCCCCCPPPPPPPPPPPPPPPPPPPPPPPPPPCCCCCCCCCCCCCCCCCC 
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CCCCPPPPPPPPPPPPPPPPPPPPPPPPPP 

pppppppppppppppppppppppppppppppppppp 


And under Windows NT it looked like this: 

CCCCCPCCCCCCCCCPPPPPPPPPCCCCCCCCCPPPPPPPPPCCCCCCCCCPPPPPPPPP 

CCCCCCCCCPPPPPPPPPCCCCCCCCPPPP 

PPPPPCCCCCCCCCPPPPPPPPPCCCCCCCCCPPPPPPPPPCCCCCCCCCPPPPPPPPPC 

CCCCCCCCPPPPPPPPCCCCCCCCCPPPPP 

PPPPCCCCCCCCCPPPPPPPPPCCCCCCCCCPPPPP 

From these two fragments you can conclude that the 
thread context switching employed by Windows NT has a 
finer resolution than that used by TNT. Nevertheless, you 
can have two applications executing concurrently under 
DOS - quite an achievement! TNT also lets you set priori¬ 
ties on processes you create. If you call Win32's SetPrior- 
ityClessO and set the priority of the child process to 
HIGH_PRIORITY_CLASS, the child process gets more CPU time, 
and will finish running before allowing the parent process 
to execute at NORMAL_PRIORITY_CLASS: 

SetPriorityClassfpi.hProcess, HIGH_PRIORITY_CLASS); 


Listing 3 threads.c — Code to demonstrate 
multithreading 


(/include (windows.h> 

(/include (process.h> 

(/include (stdio.h> 

(/include (conio.h> 

(/define STACKJIZE 4096 

void threadltchar *ms); 
void thread2(char *ms): 
char in_threadl * 1, in_thread2 = 1; 

void mainO 
{ 

char messagel * T': 
char message2 = ’2’; 

_beginthread(threadl, STACK_SIZE, Amessagel); 
_beginthread(thread2, STACK_SIZE, &message2); 

while(in_threadl II in_thread2) 
putchar('M’): 

) 

void threadltchar *ms) 

{ 

int i; 

ford = 0; i ( 2000; 1++) 
putchar(*ms): 
in_threadl = 0; 

) 

void thread2(char *ms) 

{ 

int i; 

ford = 0; i ( 2000; i++) 
putchar(*ms); 
in_thread2 = 0; 

} 

/* End of File */ 


TCP/IP for Windows 



More Windows applications than any other 
TCP/IP package 

Implemented as 100% Windows DLL (not a TSR) 
Requires only 6KB of base memory 
Installs in 5 minutes 

■ Works concurrently with NetWare, LAN Manager, 
Vines, Windows for Workgroups, etc. 
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Applications: 

TELNET (VT100,VT220, TV1),TN3270, TN5250, FTP, TFTP, SMTP 
Mail with MIME, PROFS Mail, News Reader, LPR/LPD, PING, Bind, 
Finger, Whois, Gopher, Phonetag, Scripting, Statistics, Custom, 
SNMP Agent 

Developer Tools: 

Windows Socket API, Berkeley 4.3 Socket API, 

ONC RPC/XDR, WinSNMP API 

Extensible SNMP Agent 

■ Includes MIBII, Workstation,Windows and 
DOS agents 

■ Dynamic registration of multipleagents, managers, 
and proxies 

■ WinSNMP API developers kit available 

■ Compatible with any SNMP manager 

■ Free with Chameleon, and ChameleonATvS 

NFS Client/Server 

■ Network drives are mounted from within Windows 

■ Network printing in the background 

■ Up to 24 network drives 

■ Requires only 6KB of base memory 

■ Included in ChameleomVFS 

For overnight delivery call: 

Net Manage" 

(408) 973-7171 


10725 North De Anza Blvd., Cupertino, CA 95014 USA 
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Listing 4 filemap.c — Mapping a file to memory 


//include <window$.h> 
//include <stdio.h> 


//define FILENAME 
//define FILEMAP 


■HELLO.TXT" 

'FileMappingObJect" 


void mainO 
{ 

PR0CESS_INF0RMATI0N pi = { 
HANDLE hFile, hMappedFi1e: 
STARTUPINFO si = { 0 }; 
BOOL ret_code; 
char *pFi1e; 


hFile 


CreateFilet FILENAME, GENERIC_READ|GENERIC_WRITE, 
FILE_SHARE_WRITE, NULL, 0PEN_ALWAY5, 
FILE_ATTRIBUTE_NORMAL, NULL); 
printf("CreateFile returned 5!d\n", hFile); 
hMappedFi1e = CreateFileMapping(hFi1e, NULL, 

PAGE_READWRITE, 0, 25, FILEMAP); 
printf("CreateFi1eMapping returned %d\n", hMappedFile); 
pFile = (char *)MapViewOfFi1e(hMappedFile, 

FILEJIAPJRITE, 0, 0, 0); 
printfC'MapViewOfFile returned M\n”, pFile); 
strcpytpFile, "TESTING TNT FILE MAPPING."); 
printf("\n%s\n\n", pFile); 
ret_code = UnmapViewOfFile(pFile); 
printf("UnmapViewOfFi1e returned %d\n”, ret_code); 
ret_code = CloseHandle(hMappedFile); 
pri ntf ("Cl oseHandl e (file mapping) returned M\n", 

ret_code); 

ret_code = CloseHandle(hFile); 
printfC'CloseHandle (file) returned M\n", ret_code); 

} 

/* End of File */ 



ForeHelp — 

For FREE! 

The only help authoring system for Windows 
in a true WYSIWYG hypertext environment 


This is due to round-robin scheduling - whereby the 
thread with the highest priority will always execute - em¬ 
ployed by Windows NT and emulated very well by TNT's 
scheduler. Suppose you have an application which 
launches a child program, and then wants to wait until the 
child exits before continuing. You can use Win32's Hait- 
ForSingleObjectO to wait until the child process object be¬ 
comes signaled (exits): 

WaitForSingleObject(pi.hProcess, INFINITE); 

Now the parent process launches the child process, waits 
until it exits, and then continues execution. TNT also sup¬ 
ports Win32 event objects, for synchronizing between 
multiple processes executing concurrently. Event objects 
can also be used to determine when a process exits, as in 
the following example: 

hEvent = CreateEvent(NULL, TRUE, FALSE, "EVENT"); 
CreateProcess(NULL, child, NULL, NULL, TRUE, 

NORMAL_PRIORITY_CLASS, NULL, NULL, isi, &pi); 
WaitForSingleObject(hEvent, INFINITE); 

CloseHandle(hEvent); 
for(i = 0; i < 2000; i++) 
printf("P"); 

Here the parent process creates a Win32 event object by 
calling CreateEventO and then launches the child process. 
The parent process calls MaitForSingleObjectO to wait for 
the event to become signaled. The 
child process meanwhile calls 
Open Event () to open the Win32 event 
object created by the parent: 


♦ Works directly with 
existing projects 

♦ Provides a complete 
WYSIWYG creation environment, not a 
WFW add-on 

♦ Text, graphics, & hotspots display just like 
the finished project, all without RTF codes 

♦ Use Test Mode to instantly see how your 
final project will perform without having 
to compile 

♦ Debug & manage your project with 
unique graphical presentation tools 


♦ Move among topics using hypertext links 

♦ Utilize 3.1 help features, including multimedia 

♦ Place hotspots on pictures using the built-in 
hotspot editor 

♦ Double-click on error messages during Build to 
identify error locations and make corrections 
before compiling 

♦ Use the backup facility to move and archive entire 
projects, including graphics and baggage files 


ForeHelp is quick 
and easy. 

We can prove it. 

Call 

(303)499-9181 
to order today 
or for a 

FREE demo disk. 



$395. Call for competitive upgrade info. 30-day money-back guarantee. 

ForeFront, Inc., 5171 Eldorado Springs Dr., Boulder, CO 80303 (303) 499-9181 FAX: (303) 494-5446 
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hEvent = OpenEvent( 

EVENT_MODIFY_STATE 
I SYNCHRONIZE, FALSE, 

"EVENT"); 

ford = 0; i < 2000; i++) 
printfCC"); 

SetEvent(hEvent); 

CloseHandle(hEvent); 

The child process completes its work 
before setting the event object to the 
signaled state. The WaitForSingleOb- 
jectO call in the parent process then 
returns, allowing the parent to com¬ 
plete its work. 

Thread Management 

threads, c (Listing 3) is an example 
of how to create a multithreaded ap¬ 
plication using TNT. The program 
first creates two threads using the 
_beginthread() function, and then 
continues execution in the process's 
initial thread. The first thread created 
prints the character 7 to the screen 
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2,000 times, while the second thread prints the character 
2 an equal number of times. Meanwhile, the initial thread 
continuously prints the character M as long as either one 
of the threads is still working. When the code is executed, 
the display output is a mixture of these characters that 
roughly reflects the scheduling of the three threads. When 
the code is run in DOS, the output to the screen will ap¬ 
pear uneven, and the user will see long strings of each 
character before the execution focus is switched between 
threads: 

111111111111111111111111111111111111111111111111111111112222 

222222222222222222222222222222 

2222222MMMMMMMMMMM1111111111111111111111MMMMMMMMMMMMMMMMMM22 

222222222222222221111111111111 

111111111111111111111111111111111111 

In contrast, when run under Windows NT, the code gener¬ 
ates output similar to the following: 

M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12 

M12M12M12M12M12M12M12M12M12M12 

M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12M12 

M12M12M12M12M12M12M12M12M12M12 

M12M12M12M12M12M12M12M12M12M12M12M12 

This example indicates that TNT really does context- 
switch multiple threads of execution within an application. 
However, some of the Win32 functions that TNT claims to 


Listing 5 calc.c — Example TNT DLL client 
application 


#include <stdio.h> 

_declspectdl1 export) int numl = 3; 

_declspectdl1 export) int num2 = 4; 

_declspecidl1 import) int GetSumCint numl, int num2); 

void mainO 
{ 

int sum; 

sum = GetSuminuml, num2); 

printf("\n*d + %& = %d\n", numl, num2, sum); 

} 

/* End of File */ 


support appeared to work only marginally, if at all, when I 
tested them. I had problems in getting and setting thread 
priorities with the GetThreadPriorityO/SetThreadPriorityO 
functions, and was not able to use the Win32 UaitForSin- 
gleObjectO function with thread objects. 

File Mapping 

filemap.c (Listing 4) illustrates how to use the file-map¬ 
ping features of Windows NT from your TNT DOS exten¬ 
der application. The program first creates a file named 
hello.txt by calling CreateFileO. The code then calls 
CreateFileMappingO, which creates a file mapping for that 
file, and MapViewOfFileO, which returns a pointer to a block 
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of memory containing the data from the file (now empty, 
because a new file has just been created. Next, a test 
string is copied to the pointer via the strcpy function. 
Lastly, the program calls UnmapVieuOfFileO and CloseHan- 
dle() to delete all the objects used. After running file- 
map, exe, look for the hello.txt file and examine its con¬ 
tents. Note that the code wrote to the file by using 
strcpy() to copy a string to its memory-mapped image. 

TNT does not support the Win32 OpenFileMappingO 
function, which allows other processes to open existing 
file-mapping objects and which, along with mapping re¬ 
gions of the system paging file, is commonly used by 
Win32 applications to share data among processes. 


Dynamic Linking 

TNT allows you to create and use DLLs, even under 
DOS, as demonstrated with the code in calc.c (Listing 5) 
and calcdll.c (Listing 6). calc.exe makes a call into the 
DLL named calcdll.dll. The DLL example shows how a 
TNT application can make calls into multiple DLLs under 
DOS and Windows NT. Linder Windows NT, a protected- 
mode DOS DLL could conceivably be shared by multiple 
DOS and Win32 applications concurrently, calcdll.dll ex¬ 
ports GetSumO, which accepts two integers as parameters, 
adds them, and returns the result to the caller, which 
prints the answer: 

3 + 4 = 7 
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Under Windows NT, DLLs are loaded 
only once, and then shared by all 
processes that wish to access them in 
the system. Windows NT automat¬ 
ically allocates a new DLL data seg¬ 
ment for each process attaching it¬ 
self. Since multiple applications use 
the same code base, Windows NT is 
able to save memory. TNT does not 
currently support this functionality, so 
for each application that attaches to 
a DLL, a new copy of that DLL is 
loaded into memory. 
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Console Management 

All Windows NT style TNT applications are console¬ 
mode programs. A console application is a text-mode 
Win32 application. Such applications can be run in text 
mode, like DOS applications, or in a window, like DOS ap¬ 
plications in Windows 3.T Console applications are not 
DOS applications, but rather full 32-bit programs that can 
take full advantage of the Win32 API. TNT supports all of 
the Win32 console-mode functions. Some functions are 
supported by TNT, but do not have meaningful implemen¬ 
tations on all TNT platforms. For instance, SetConsoleTi- 
tle() sets the title-bar string of a console application when 
it is in a window. Under DOS, this function has no real 
purpose as there are no windows. Under Windows 3.1, 
your TNT application may be running in a window, al¬ 
though SetConsoleTitleO does nothing. 

Memory Management and Compiler Support 

TNT adheres to all major memory management 
schemes. Upon startup, TNT checks for all standard mem¬ 
ory managers and other extended system software and 
then configures itself properly. The application itself does 
not need to worry about any of this. TNT works properly 
with XMS (extended Memory Specification), VCPI (Virtual 
Control Program Interface), and DPMI (DOS Protected 
Mode Interface). If no advanced system software is de¬ 
tected, TNT will access extended memory directly with its 
own services. 


Listing 6 calcdll.c — Example TNT DLL code 


#define _DLL 

#include <stdio.h> 
include <pharlap.h> 

_declspectdl1 import) int numl, num2; 

_declspecCdl 1 export) int GetSumdnt numl, int num2): 


ULONG_stdcal 1 D11EntryPoint(void *hDll, ULONG Reason. 

void ‘Reserved) 

{ 

return TRUE; 

} 

int GetSumdnt numl, int num2) 

{ 

return (numl + num2); 

} 

/* End of File */ 


The TNT DOS-Extender also supports all major 32-bit 
compilers, including Microsoft Visual C/C++, Watcom 
C/C++, MetaWare High C/C++, Borland C++, and Syman¬ 
tec C++. Linking is accomplished with 386LINK, which is 
provided by Phar Lap; for Visual C++, Microsoft's linker 
may be used. To debug your TNT DOS-Extender programs, 
Phar Lap provides a special 32-bit version of Microsoft 
CodeView. 
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Visual C++ and TNT 

Perhaps the most popular TNT 
DOS-Extender application written to 
date is Microsoft's 32-bit Visual C++ 
compiler for Windows NT. Microsoft 
has taken full advantage of the 
power offered by TNT to allow its 
command-line Visual C++ compiler 
to run in Windows NT, DOS, and 
DOS boxes under Windows 3.1. If 
you run Phar Lap's MAPEXE utility on 
the Visual C++ executables, you will 
discover that they are all marked as 
console-mode applications in the PE 
format. This means that Visual C++ is 
a native Win32 application, which in 
turn means that it need not run 
through any translation layer in Win¬ 
dows NT. Obviously, the majority of 
32-bit Visual C++ users will develop 
Windows NT applications, so it is im¬ 
portant that the compiler run quickly 
and efficiently in this environment. 
Since Visual C++ uses TNT DOS-Ex- 
tender technology, users who de¬ 
velop Win32s applications or 32-bit 
DOS extended applications can run 
the Visual C++ compiler directly 
from DOS, as a protected-mode 
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DOS application, or from an MS-DOS 
box in Windows 3.1, using Windows' 
DPMI services. If Microsoft had not 
used the TNT DOS-Extender, these 
developers would be forced to com¬ 
pile their applications under Win¬ 
dows NT, then reboot into DOS - 
and possibly Windows 3.1 - in order 
to test their applications. Visual C++ 
is an excellent showcase for the 
power the TNT DOS-Extender can 
bring to your application. 

TNT and Interrupt Handlers 

One common problem faced by 
TNT applications is the need to ac¬ 
cess a real-mode software interrupt 
from protected mode. TNT handles 


standard DOS and BIOS services 
gracefully, by intercepting your inter¬ 
rupt, switching into real mode, reissu¬ 
ing the interrupt, reentering protected 
mode, and returning execution con¬ 
trol to your application. When control 
returns to your application, all gen¬ 
eral registers and flags contain the 
values that the real-mode interrupt 
handler provided. For undocumented 
calls or services provided by software 
other than DOS or BIOS, TNT pro¬ 
vides a system call (2511h) which will 
properly issue an arbitrary real-mode 
interrupt. Although this makes life 
easy in most cases, the overhead of 
a mode switch is approximately 58 
microseconds on a 25 MFIz 80386 and 


Figure 1 Win32 functions supported by TNT 
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30 microseconds on a 25 MHz 80486 computer. 

Suppose you have a real-mode application that does 
interrupt-driven serial communication. If the application is 
then ported to protected mode, with the hardware inter¬ 
rupt handler left as is, then every time data is read from 
or written to the serial port, TNT is forced to switch to real 
mode to carry out your request. At this point the over¬ 
head of mode switching becomes an issue. As you ap¬ 
proach communication speeds of approximately 9600 bps 
(bits per second), you may begin to lose data, especially if 
you have a multithreaded application. One possible solu¬ 
tion is to rewrite the interrupt handler for protected mode. 

This solution, however, has a serious flaw, as it does 
not take into consideration the possibility that an interrupt 
may sometimes occur while the processor is in real mode 
(hardware interrupts are asynchronous events and may 
occur anytime). TNT solves this rather complex problem 


with support for bimodal interrupt handlers. A bimodal in¬ 
terrupt handler is a set of two complementary interrupt 
handlers: one handler responds to interrupts that occur in 
real mode, and while the other services interrupts that oc¬ 
cur in protected mode. This solution eliminates the over¬ 
head imposed by switching between processor modes. 

Summary 

As Visual C++ demonstrates, there is still a need for 
DOS extenders and a market for DOS-extended applica¬ 
tions. TNT DOS Extender allows you to create a single ex¬ 
ecutable for use with DOS, Windows 3.1, and Windows 
NT. More important, by offering a subset of NT's API un¬ 
der Windows 3.1 and DOS, your extended DOS applica¬ 
tion does not have to 'dumb down' to the lowest com¬ 
mon denominator platform, and can take advantage of 
DLLs, threads, and process management. □ 


What’s New in 6.1 


I reviewed TNT DOS-Extender v6.0, but Phar Lap 
has since begun shipping version 6.1 of the product. 
The main feature of the 6.1 release is support for 
Microsoft Visual Basic 3.0 for Windows. Phar Lap 
now recommends that you develop your application 
as 32-bit TNT DOS-Extended, which allows it to run 
as a standalone DOS application, then, if appropriate, 
use Visual Basic to develop a Windows interface for 
the DOS application. Your DOS users will still have a 
standalone DOS application, and your Windows users 
will be happy that your application takes full advan¬ 
tage of the GUI environment. Best of all, both the 
DOS and Windows versions of your application can 
be built from essentially the same source code. 

Other new features of TNT DOS-Extender, Version 
6.1, include: 

• Support for Borland C++ 

• Full support of console Win32 APIs 

• Better thread support 

How It Works 

Converting a TNT application for use with Win¬ 
dows requires several steps. The most difficult (and 
probably the most fun) is the design of your GUI in¬ 
terface in Visual Basic. You can create the Visual Ba¬ 
sic forms for your application using all the fancy con¬ 
trols, menus, status bars, and other trimmings one ex¬ 
pects of a GUI application. The Visual Basic interface 
composes the Windows side of your application, 
while your original DOS-Extended application be¬ 
comes the DOS side. 

When the user double-clicks on your application in 
Program Manager, one of the first things your Win¬ 


dows side must do is launch the DOS side. This is 
usually done by means of a Program Information File 
(PIF), which ensures that the proper settings for run¬ 
ning the DOS side have been selected. Specifically, 
you want to ensure that the 'Windowed' radio but¬ 
ton is selected, as well as the 'Background' check¬ 
box. This allows the DOS side of your application to 
be minimized on the screen, while still running in the 
background. You will want to create this PIF and then 
include it as part of the standard distribution of the 
Windows version of your application. In addition, you 
will probably want a Windows setup program for the 
purpose of installing your application from floppy 
disks. 

Once the DOS side of your application is loaded 
and minimized on the screen, the user can begin us¬ 
ing the GUI interface. As the user works with the Vis¬ 
ual Basic interface (selecting items from menus, work¬ 
ing with dialog boxes, etc.), your Windows side must 
notify the DOS side about the user's actions so that 
the DOS side can do all the real work of processing 
data. This is accomplished via what Phar Lap calls the 
WinPipe API, a set of calls that allow you to send 
messages between the Windows and DOS sides of 
your application. The messages can be composed of 
integers or strings of data. The WinPipe API consists 
of a 16-bit DLL (Dynamic Link Library) for the Win¬ 
dows side of the application, a 32-bit library for the 
DOS side, and the PHARLAPX VxD (Virtual Device). 
Since your 32-bit DOS-Extended program runs in one 
VM (virtual machine) under Windows and your Visual 
Basic interface runs in the System VM, communica¬ 
tion between the two has to occur via a VxD. □ 
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Microsoft’s Compression File 
Format 

Pete Davis 



Borland C++ v4.0 
Symantec C++ v6.1 
Visual C++ vl .5 


Microsoft supplies file compression software in the form of two utilities (com¬ 
press. exe and expand.exe) and one Windows library (lzexpand.dll). Unfortunately, 
Microsoft does not document the compressed file format that these programs 
use. Without knowing the file format, third-party developers cannot create com¬ 
patible software that goes beyond what Microsoft's three modules offer. This 
article provides the first public documentation for this compressed file format. 

LZ77 Overview 

There are a variety of algorithms for general purpose data compression. 
PKZIP, for example, uses several different algorithms, selecting the one that 
provides the best compression for the data at hand. Some algorithms are spe¬ 
cific to certain types of data, for example, GIF and JPEG, which are used for 
graphic image compression, compress.exe uses an adaptation of what's com¬ 
monly known as the L277 compression algorithm. LZ77 was developed in a 
paper by Abraham Lempel and Jacob Ziv in 1977, hence the name. LZ77 uses 
what's called a dictionary-based, sliding window compression. This section 
gives you an overview of that algorithm. 

The easiest way to understand the LZ77 algorithm is to view it as a fancier 
version of simple run-length encoding. Simple run-length encoding replaces 
strings of repeated characters with a single character and a count. For example, 
suppose you wanted to run-length encode the following string of ASCII input 
data: 

aaaaabbbbbaaaaabbbbb 

To compress this string, you could use a simple algorithm: Copy the first input 
byte to the output string, then add up the number of times this input byte is 
repeated and copy that number to the output string. The result might look like 
this (I use square brackets to denote the decimal value of a single ASCII byte): 

a[4]b[4]a[4]b[4] 


For this input string, the algorithm compressed a 16-byte string into an 8-byte 
string. Of course, requiring every other character to contain a repetition count 
means that some strings will actually get bigger when compressed. For exam¬ 
ple, this string: . .. 

° (continued on page 60) 
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abcdabcd 

would be twice as large: 
a[0]b[0]c[0]d[0]a[0]b[O]c[0]d[0] 

Run-length encoding is simple to perform, but only per¬ 
forms well on very repetitive data. What if you extended 
run-length encoding to look for repeated strings, rather 
than just repeated instances of a single character? For ex¬ 
ample, the input string above contains a repetition of the 
string 'abed'. You could replace the second occurrence of 
this string with two numbers, the offset and length of the 
string in the uncompressed string to repeat. Ignoring the 
problem of how to distinguish offset/length bytes from 
data bytes, the previous example could compress to a 
string like this: 

abcd[0,4] 

This is the basic idea of LZ77 compression. Instead of stor¬ 
ing a repetition count for a single character, the compres¬ 
sion software stores the offset and length of a string of 
characters that is repeated. 

I said that LZ77 is a dictionary-based sliding window 
algorithm. 'Dictionary-based' means that the compression 
algorithm creates a list of the strings or symbols that it 
has discovered are repeated in the input. The compressor 
is typically much more complex than the decompressor, 
since it has to locate repeated strings and select the ones 
that provide the best compression. I also said that LZ77 
uses a 'sliding window'. Remember that LZ77 has to store 
the offsets and lengths of the strings to repeat. In general, 
the data being compressed could be huge, so each offset 
could require as much as four bytes (assuming your maxi¬ 
mum file is 4 gigabytes). Instead, LZ77 limits itself to re¬ 
peating strings that have occurred within a fixed window 
behind the current character in the decompressed output 
stream, compress.exe uses a sliding window size of 4096, 
which means that it only needs 12 bits to encode a string 
offset. The sliding window means that the algorithm can¬ 
not take advantage of strings that occur early in the input 
and are repeated much later (more than 4096 bytes later), 
but in practice this disadvantage is made up for by the 
smaller space required for encoding string offsets. 

Encoding Details 

One problem that both run-length encoding and LZ77 
have to deal with is how to distinguish data bytes from 
compression codes (lengths and offsets). As mentioned 
earlier, compress.exe uses a 4096-byte sliding window, 
which means that it needs 12 bits to represent a string 
offset. To keep things within byte boundaries, that leaves 
four bits to encode string lengths; compress.exe then re¬ 
quires two bytes to store the codes (length and offset) that 
represent any repeated string. 

To distinguish data bytes from compression codes, com¬ 
press.exe divides its output into chunks of eight items, 
where each item is either a simple data byte from the 


Page 60 — Windows/DOS Developer’s Journal 


July 1994 









Figure 1 

Hex dump of compressed text 


Offset 

Hex Values 

Ascii 

0x00000000: BF 50 6C 65 6E 74 79 EF F3 69 F7 66 75 6C EF 
0x00000010: 65 6F 75 73 ID 20 F8 F2 63 

F3 .Plenty..i.ful.. 
eous. ..c 


original uncompressed string, or a 
two-byte compression code. Each 
chunk of eight items is preceded by a 
flag byte, each of whose bits specifies 
whether the corresponding item is 
just a data byte or a two-byte com¬ 
pression code. 

In each flag byte, a set bit means 
that the corresponding compressed 
byte is a data byte; a clear bit means it's a two-byte com¬ 
pression code. So, if you had a flag byte of 0x07, the bi¬ 
nary equivalent would be 11010111. Bits 1 -3 are set, so 
the next 3 bytes would be unaltered bytes from the origi¬ 
nal file. Bit 4 is clear, so that means there would be a 
compression code following the three bytes. Bit 5 is set, so 
the next byte is a data byte. Bit 6 is clear, indicating an¬ 
other two-byte compression code. Bits 7 and 8 are set, 
indicating two more bytes of literal data. 

The compress.exe Header 

The C structure I use to represent the header for a file 
compressed with compress.exe is: 

typedef struct tagCOMPHEADER { 

long Magi cl; /* 0x44445A53 */ 

long Magic2; /* 0X3327F088 */ 

char Is41; /* 0x41 */ 

char FileFix; /* -r char fix*/ 

long DecompSize; 

} COMPHEADER; 

The header begins with nine bytes of data that seem to 
be the same for all files produced by compress.exe. The first 
four bytes are the letters 'SZDD,' which means absolutely 
nothing that I can think of, but I'd hazard a guess that it's 
two people's initials. The next four bytes are 0x88, 0x80, 
0x27, and 0x33, respectively. These also mean absolutely 
nothing that I can fathom. The third field, Is41, is always 
set to 0x41, as far as I can tell. 

The fourth field, FileFix, is a character to repair any 
filename mangling done by compress.exe ; if you use that 
program's '-r option, it will automatically change the 
name of the compressed file, usually removing the last 
character of the extension and replacing it with an under¬ 
score. The FileFix field contains the original character 
from the filename, expand.exe provides a '-r* option to re¬ 
place this character in the decompressed file's filename. 
The last field, DecompSize, is the size of the original file 
prior to compression. This can be used to double-check 
the decompression or simply to find out how much space 
the destination drive of the decompression will require. 

Decompression 

Following the COMPHEADER structure is the actual com¬ 
pressed data. As discussed previously, the data is in the 
form of a flag byte, followed by eight items, each of which 
is either a data byte or a two-byte compression code. Each 
two-byte compression code contains a 12-bit offset and a 
4-bit length. The offset describes how far from the start of 


the current window the replacement string begins. The 
length describes how long that replacement string is. 

The length is taken from the lower four bits of the sec¬ 
ond byte of the two-byte code. Four bits for the length 
means that the replacement string could be anywhere 
from zero (0x00) to fifteen (0x0F) bytes long. However, there 
is no point in replacing a one-byte or two-byte string with 
a two-byte code, since there would be no space savings. 
Therefore, the length field is biased by 3 - you always 
add 3 to the length field, and it can thus specify replace¬ 
ment strings of from 3 to 18 characters. 

The least significant bits of the offset reside in the first 
byte of the two-byte code; the most significant bits are the 
upper four bits of the second byte of the two-byte code. 
For some strange reason, the offset is biased by 16 - you 
must always add 16 to the 12-bit, unsigned offset to ob¬ 
tain the correct offset. For example, a two-byte code that 
refers to a five-byte string at offset 0 would look like this 
in hex: (continued on page 62) 
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F0 F5 


The length field would be equal to 0x05, while the offset 
would be 0xFF0, to which you add 16 to obtain (as a 12- 
bit number) 0x000. I use the following macro to obtain the 
offset from the two-byte code: 


Listing 1 Declarations for decompression program 


/**★***★****★*★**★*★*★***★★★★★*★*★**★****•*:★★★*★★**** 

DECOMP.H 

Pete Davis - 11/93 

typedef struct tagCOMPHEADER { 
long Magicl; 
long Magic2; 

char Is41; /* 0x41 */ 

char FileFix; /* Character saved for -r option */ 
long DecompSize; 

} COMPHEADER; 

/* Magic #s for MS-LZ77 - First magic# "SZDD" */ 

#define MAGIC1 0x44445A53 
#define MAGIC2 0X3327F088 

/* Constants and Macros for decompression */ 

//define WINSIZE 4096 

#define LENGTH(x) ((((x) & 0x0F)) + 3) 

#define OFFSETtxl, x2) \ 

((((x2 & 0xF0) « 4) + xl + 0x0010) & 0X0FFF) 

//define WRAPFIX(x) ((x) & (WINSIZE - D) 

#define BITSET(byte. bit) (((byte) & (l«bit)) > 0) 

/* End of File */ 


//define 0FFSET(xl, x2) \ 

((((x2 & 0xF0) « 4) + xl + 0x0010)\ 

& 0X0FFF) 

An Example 

Figure 1 shows a hex dump of some compressed words. 
The words are, in this order, 'Plenty", 'Plentiful', 'Plenteous', 
and 'lentic". Each is separated by a space (not a comma). 

The first byte in the dump is a flag byte value of 0xBF. 
In binary, this is 10il 111 1. That means the first 6 bytes 
should be copied directly to the output file. The 7th byte is 
a two-byte compression code, and the 8th byte should 
also be copied to the output. So, you copy the first 6 bytes 
and you get 'Plenty' as the first 6 decompressed bytes. 
Next comes the two-byte compression code: 0xEF 0xF3. 

The length of the replacement string is the lower 4 bits 
of 0xF3, which is 3, to which you must add 3 (as discussed 
earlier) to obtain a length of 6. Where do you copy 6 
bytes from? You have to calculate that within the output 
window. The offset is composed of the upper 4 bits of 
0xF3 and all of 0xEF, which gives you 0X0FEF. To this value, 
you add 16, leaving a value of 0xFFF. Well, it's obvious 
you don't have 4096 bytes in the output window yet, so 
why would it point to the last byte of the window? This 
threw me at first, too. It turns out that the decompression 
window must be filled with spaces or 0x20 bytes prior to 
decompression. You would then start copying from the 
last byte of the window (which is initialized to 0x20) and 
wrap around to the beginning of the window, so the 6 
bytes would be 0x20 (space) followed by the letters 'Plent'. 
The next byte is not a compression code, so you simply 
copy the byte, leaving you with the following in your out¬ 
put stream: 'Plenty Plenti'. The rest 
of the input is processed in the same 
manner. 

The Code 

decomp.h (Listing 1) and decomp, c 
(Listing 2) contain a program that 
performs essentially the same func¬ 
tion as expand.exe except that it 
doesn't support the '-r' option to re¬ 
trieve the last character of the file ex¬ 
tension. As I said before, the sliding 
window is 4096 bytes long. One of 
the concerns is how to handle the 
window when it fills up. If you had a 
full window, it would be horribly inef¬ 
ficient to shift every byte in the win¬ 
dow one byte over to make room for 
a new byte. Instead, the window 
wraps and the physical beginning of 
the window itself shifts. It's more or 
less a circular queue. To make this 
easier, I use the WRAPFIX macro to de¬ 
termine the actual position in the 
window. 

My implementation does I/O 
one byte at a time. This does hurt 
performance, but for the sake of 
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demonstration, performance wasn't a real concern. Actu¬ 
ally, the performance of my code isn't far behind that of 
expand, exe. 

Summary 

That's really all there is to it. Compared to most compres¬ 
sion algorithms, LZ77 decompression is very simple to under¬ 
stand and easy to implement. Compression is somewhat 
more complex, because you have to decide which strings in 
the sliding window to replace to obtain the best compression. 


Fortunately, decompression will work correctly no matter 
which of several possible algorithms was used to select 
the strings that get replaced with compression codes. 
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Listing 2 Source for decompression program 


#1nclude <stdio.h> 


include <stdlib.h> 

void ReadHeaderlFILE ‘infile. FILE ‘outfile) { 

((include <string.h> 


((include "decomp.h" 

COHPHEADER CompHeader; 
long CompSize; 

/* 4k Decompression window */ 


char WindowCUINSIZE]; 

fseek!Infile, 8, SEEK.END); 

CompSize * ftel 1 (infile); 
fseektinfile. 0, SEEK_SET); 

Decompresses the data using Microsoft’s LZ77 

freadUCompHeader, sizeof(CompHeader), 1, infile); 

derivative. 

if ((CompHeader.Magicl 1= MAGIC1) 


II ( CompHeader.MagicZ != MAGIC2) ) { 

void DecompressiFILE *inf11e, FILE *outfile. long CompSize) { 

printft "Fatal Error:\n"); 

printft" Not a valid Compressed file flleUn”); 

unsigned char BitMap, bytel, byteZ; 

return; 

int Length, counter; 

1 

long Offset, CurrPos=0; 



printfCDecompressing file from Jlu bytes to %lu bytestn". 

/* Init our window to spaces (0x28) */ 

CompSize, CompHeader.DecompSize); 

for (counter = 8; counter < WINSIZE: counter ++) 


Windowtcounter] « ’ 

Decompress(infile, outfile, CompHeader.DecompSize): 
pr1ntf("Done!\n"); 

/* Go through until we’re done */ 


while (CurrPos < CompSize) ( 

} 

/* Get BitMap (flag) and data following it */ 


BitMap = fgetc(infile); 

void Usage(void) { 

if (feof(infile)) return; 



printf("Usage;\n"); 

/* Go through and decode data */ 

printft" DECOMP filel.ext file2.ext\n\n\n"); 

for (counter = 8; counter < 8; counter*-) { 

printft" filel.ext - Name of comrpessed file\n"); 
printft" fi 1 eZ.ext • Name of decompressed file\n\n“); 

/* It’s a code, so decode it and copy the data */ 


if <! BITSET(BitMap. counter)) { 

) 

bytel = fgetc(lnfile); 

Open the file and dump it. 

/* Shouldn’t be EOF, but just In case... */ 

if (feof(infile)) return; 

**•* *•* *•*' *•* *•* *'* * * * * * * *k***1rnir*1r1c1^ 

byte2 = fgetc(infile); 

int mainlint argc, char *argv[]) { 

Length = LENGTH(byte2); 


Offset = OFFSETtbytel, byteZ); 

char filename[128]; 

FILE ‘infile, ‘outfile; 

/* Copy data from ’window’ */ 


while (Length) { 

if (argc < 3) { 

bytel = WindowCWRAPFIX(Offset)] : 

Usage!); 

Hindow[HRAPFIX(CurrPos)j = bytel; 

return EXIT FAILURE; 

fputctbytel, outfile); 

) 

CurrPos*; 


Offset*; 

strcpytfilename, argv[l]); 

Length--; 

If ((infile = fopenifilename. "rb")) == NULL) { 

> 

printfCKs does not exist!’’, filename); 

}/* if */ 

return EXITJAILURE; 

else { 


bytel = fgetc(infile); 

strcpytfilename. argv[2]); 

WindowCWRAPFIX(CurrPos)] = bytel; 

if (( outfi 1 e=fopen(f11ename. "wb")) == NULL) { 

fputctbytel, outfile); 

printf("Error opening destination file!"); 

CurrPos*; 

} 

If (feofdnfile)) return; 

return EXIT FAILURE; 

} 


ReadHeader ( infi 1 e. outfile); 

}/* for */ 

fclose(infile); 

)/* while */ 

} 

fclose(outfile); 

return EXIT_SUCCESS; 

Reads the compressed file’s header and checks 

J 

/* End of File */ 

to make sure it’s a valid MS-LZ77 compressed file. 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


The Best C/C++ Tips Ever 

Anthony Porter 
$29.95 

Osborne McGraw-Hill, 1993 
ISBN 0-07-881820-6 



Publishers, not authors, usually have the last say on 
book titles. Thus my fantasy of someday receiving a book 
humbly titled 'Some Halfway Decent Code for Limited 3D 
Graphics Under 16-bit Windows” seems likely to go unful¬ 
filled. That being the case, I must content myself with 
crossing out the hyperbolic titles of the books I receive 
and writing in my own. This particular book I have retitled 
'10% Best C/C++ Tips, 70% Harmless Repetition, and 
20% Misinformation.” 

This book does not have page numbers but it consists 
of 405 numbered tips. The book claims to assume 'you 
understand at least the basic syntax and semantics of C or 
C++'; if that were true then the book would be smaller by 
half. In fact, many tips are mere repetition of language 
facts, or are trivial in nature. Judge for yourself: Tip #9 is 
'The order of evaluation of function arguments is not de¬ 
fined”; Tip #10 is 'Do not confuse the = and == opera¬ 
tors”; Tip #33 is 'Static items local to a function are pre¬ 
served across function calls'; Tip #83 is 'ANSI C allows 
structure assignment”; Tip #104 is 'The :: operator will un¬ 
cover a hidden file scope item”; Tip #121 is 'A pure virtual 
function may be defined”; Tip #206 is 'List of Operators'; 
Tip #215 is 'Understanding the function call operator.” It 
requires no understanding of programming for an editor 


to ask of some of these 'This isn't really in the form of a 
tip, is it?” but that doesn't seem to have happened. The 
book lists an acquisitions editor, an associate editor, a 
technical editor, a project editor, and a copy editor, but it 
needed a plain old editor editor, someone determined to 
keep the book to its stated form and focus. 

I expect a book of this form to sometimes make 
sweeping statements that trivialize important design is¬ 
sues, such as Tip #117, which says ‘Virtual functions may 
be useful, but you should avoid declaring all class member 
functions as virtual just in case a derived class might need 
to redefine one of them.” However, I don't expect things 
like Tip #133, which says 'When you declare a static class 
member function, that function may only access the static 
class data. This is true even if there is an instance of the 
class.” This is incorrect, confused, and confusing: a static 
member function can access the members of any objects 
of its class that it can lay hands on, it just doesn't have an 
object implicitly associated with it as non-static member 
functions do. 

The author claims that Chapter 11 covers ANSI C func¬ 
tions, but he has somehow obtained a copy of the ANSI C 
standard from an alien dimension, a dimension in which 
the UNIX function swabO has retroactively been added to 
the standard, a dimension in which the standard function 
tmpnamO has been renamed to tempnamO, and so on. In 
short, the author has not grasped the fact that his PC C 
compiler's runtime library is not equivalent to the ANSI C 
library specification. 

Many of the tips that I thought were reasonable appear 
also in the sources cited at the beginning of the book, 
including Myers' Effective C++ and Coplien's Advanced C++ 
Programming Styles and Idioms. Those are books I can rec¬ 
ommend (especially Myers' book), but for this book I can 
only offer the old literary indictment: it's good and it's 
original, but the part that's good is not original, and the 
part that's original is not good. 
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Programmer's Guide to the 
AMIBIOS 

American Megatrends, Inc. 
$32.95 

Windcrest/McGraw-Hill, 1993 
508 pages 

ISBN 0-07-001562-7 



The BIOS usually gets a parsimonious section or appen¬ 
dix in books about larger PC programming topics. This 
book is a reference for one of the more popular BIOSs in 
existence, that of American Megatrends, Inc. (AMI). The 
original idea of the BIOS was simple, to provide a stand¬ 
ard interface layer between DOS and the hardware (disk 
drive, clock, serial port, etc.). The functionality in the BIOS 
has grown steadily, however, adding real-time clock serv¬ 
ices, support for the Advanced Power Management specifi¬ 
cation, PCMCIA socket services, and more. 

About 100 pages of the book are devoted to docu¬ 
menting AMI BIOS setup options. Many of the setup 
screen entries are self-explanatory, but some (like 'fast 
gate A20 option') benefit from this extra documentation. 
This section also includes a table of the 46 predefined 
hard disk types, which can be handy. Other topics covered 
in reference manual style include the layout of BIOS data 
(in RAM, ROM, and CMOS), I/O port addresses, ROM inter¬ 
rupt services (including Advanced Power Management and 
PCMCIA functions), keyboard controller information, and 
error messages. Tables and lists form the bulk of the 
book, with few examples of use or elaboration. 

What I would really like on my shelf is something like 
'Bob's Big Book of BIOSs,' which would document the 
functions and data structures that all BIOSs have in com¬ 
mon as well as the differences between and extensions of 
the most common third-party BIOSs. Since I know of no 
such book, nor anyone named Bob who is working on 
one, this book is an acceptable substitute. 


PC Interrupts. 2nd edition 
Ralf Brown and Jim Kyle 
$39.95 

Addison-Wesley, 1994 

1216 pages 

ISBN 0-201-62485-0 


SECOND EDITION 


s 


A PROGRAMMER’S REFERENCE TO 
BIOS. 1 X)S. .AND THIRD -PARTY CALLS 


RALE BROWN & JIM KITE 



While there is no 'Bob's Big Book of BIOSs', there is 
'Ralf and Jim's Gigantic Book of Interrupts,' and this is it. 
Actually, this is only part of it - it has gotten so big that a 
separate book, Network Interrupts, is coming out to hold 
the overflow. This book, known to the online community 
as "the interrupt list', is an exhaustive enumeration of all 
the interrupt functions, sub-functions, and sub-sub-func- 
tions offered by the BIOS, DOS, Windows, TopView, 
DESQView, and dozens of other third-party applications. 

The interrupt list is one of those neat projects that 
comes about when one person donates a significant part 
of his/her life and the programming community donates 
its distributed expertise (another example is MicroEMACS, 
tirelessly maintained by Daniel M. Lawrence, with porting 
and other input from programmers at large). Ralf Brown is 
the maintainer of the online interrupt list, which he and Jim 
Kyle made into a book. This huge list has been circulating 
and growing for years, and now you can have the latest 
version on your bookshelf for about three cents per page, 
cheaper than you can print the list on your laserjet. 

I have one serious complaint about the interrupt list: 
there is no information on where to obtain published 
specifications, nor even a clear indication of what specifi¬ 
cations are publicly available. This book is a succinct refer¬ 
ence, but the real specifications (when available) have 
more complete and descriptive information than is avail¬ 
able in the interrupt list. For example, chapter 65 covers 
the interrupts used by the DCA/Intel Communicating Appli¬ 
cations Specification, but makes no mention of how you 
can obtain this specification. Likewise, VCPI, DPMI, LIM 
EMS, and other specifications are covered at the interrupt 
level, with nary a note on how or where to obtain the 
complete specification. 

Pet peeves aside, this is a monumental effort and the 
authors are to be congratulated. Every advanced PC pro¬ 
grammer will want this reference text on his/her bookshelf. 



Leaping from BASIC to C++ 
Robert J. Traister 
$34.95, includes code disk 

AP Professional, an imprint of 
Academic Press, a division of 
Harcourt Brace a Company, 1994 

ISBN 0-12-697421 -7 


I can't fault the title of this book - trying to move from 
BASIC to C++ is definitely a leap, not a step. Actually, the 
title could be a little more specific, something like 'Moving 
from GWBASIC or QBASIC to Borland C++ on the PC' 
would be more accurate, as the text is often unconsciously 
specific to those products. The title does correctly describe 
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the main point of the book, as well as the main problem: 
is it reasonable to expect to move straight from BASIC to 
C++? I'll return to that question later. 

One pet peeve I have about books that teach program¬ 
ming is that the prose needs to be precise. Someone 
learning elemental language concepts is forming mental 
models that remain in place for some time, so confusing 
and ambiguous prose can create programmers with 
deeply held, wrong beliefs. For example, this book intro¬ 
duces the concept of structures by saying 'A struct begins 
with a template." Goodness! Imagine the reader's surprise 
when, much later, he or she accidentally discovers that 
what the author calls a 'template' is what everyone else 
calls a 'declaration,' and that 'template' is actually a com¬ 
pletely different C++ language feature that is not men¬ 
tioned anywhere in this book! This is not just a slip of the 
pen; the. word "template' is used throughout the book to 
refer to structure or union declarations. 

One big hurdle for some BASIC programmers will be 
understanding pointers or, more generally, thinking in 
terms of how data is physically laid out in memory. De¬ 
scribing this material to a BASIC programmer cries out for 
diagrams and pictures, but of the three or four diagrams 
in the entire book, none relate to describing pointers. Like¬ 
wise, the simplest way to describe unions is to draw a 
picture and discuss memory addresses. Instead, the book 
offers paragraphs of laborious prose like 'While a union is 
a variable that can store different data types, it can only 


store one at a time, as opposed to a struct which simulta¬ 
neously stores a collection of data types.' 

As with the lion's share of PC programming books, this 
one suffers from a lack of strong editing. A good editor 
would not have let the author insert the source code to 
Borland's iostream.h, all 14 pages of it, just to prove the 
point that I/O is actually a complex operation in C++ (as 
well as pushing the bounds of the 'fair use' doctrine). A 
good editor would have saved the author the embarrass¬ 
ment of amusingly misspelled idioms, such as: 

... but the experience still sticks in my crawl. 

A good technical editor would have caught a variety of 
misleading and downright incorrect characterizations of 
C++, like this one, which purports to explain why one 
should use new and delete instead of malloc() and free(): 

As we have learned, functions are less efficient than opera¬ 
tors, so the C++ memory operators are used almost exclu¬ 
sively. 

Even ignoring the wrong-headed philosophical aspect of 
this statement, the author apparently never noticed that 
new and delete are implemented on top of malloc() and 
free() in the compiler package he is using, making it some¬ 
what unlikely that they are in any way more efficient. 

On the positive side, BASIC programmers will definitely 
find it comforting to have a new language presented in 



INFORMATION 

INSTANTLY! 


C/C 


++ 

Users loumaf 


Advanced Solution! for C/C++ Programmer* 

Windows/DOS 

D DEVELOPER S JOURNAL 



On-Line Index Updated for 1993! 




* 


1/T 


Find 6 years of indepth real-world information in seconds. 
Unleash the full potential of your C/C++ User’s Journal and 
Windows/DOS Developer’s Journal library. 


I 


• Detailed three-level subject index. 

• Each article, letter, and question and answer listed under 
numerous indexing terms. 

• All entries include the title, author, and references to other 
articles, journal issue, and page. 


Special Offer 


For Owners of the 1992 Index, 
buy the update for only $9.95! 
Order W63DU. 



Identify Source Code INDEXW1 to Order W63D Today! 

Call 913-841 -1631 FAX 913-841 -2624 

1601 West 23rd Street, Suite 200, Lawrence, Kansas 66046-2700 


O Request 181 on Reader Service Card O 



July 1994 


Windows/DOS Developer’s Journal — Page 67 




















terms of BASIC constructs. Where is my PRINT statement, 
my MID$0 function? The book gently guides the reader 
toward replacing familiar tools with new ones, although 
not always toward making the best use of the new tools 
- if one writes BASIC-like code in C++, is that progress? 
Still, one could do worse for a BASIC programmer than to 
give them this book, tell them to take it with a big grain 
of salt, and then point them toward a good mainstream 
C++ book. 

My theory is that BASIC programmers come in two 
categories. First, there are the hobbyists who are using BA¬ 
SIC strictly as a means to an end, and are unconcerned 
with programming as an art, craft, or science. Second, 
there are the 'real' programmers, for whom BASIC has 
simply happened to be the best choice of programming 
language for the problems at hand. I think it is eminently 
feasible for this latter category of programmer to just grab 
a copy of Stroustrup's The C++ Programming Language and 
start learning. The former category is the one that has me 
worried, especially since the book's preface describes the 
prototypical reader as one thinking of starting to program 
for a living, but coming face-to-face with the fact that the 
job market is calling for more C++ programmers than BA¬ 
SIC programmers. Given the way programmers are hired, I 


do believe the book will help hobbyists of this kind con¬ 
vince potential employees that they are C++ program¬ 
mers. I just hope none of their code winds up operating 
medical equipment or the space shuttle. 

One final note: few people can actually make a living 
writing programming books, and the author reminds the 
reader of this by devoting an entire chapter to a commer¬ 
cial product he sells - a program called CBreeze++ that 
converts BASIC source code to C++. In fact, the cover of 
the book says 'Includes Portions of CBreeze++ Translation 
Software,' which led me to assume that the included disk 
would contain a crippled version of the translator. That 
might be a little tacky, but one could argue that for tuto¬ 
rial purposes, the reader really only needs to translate tiny 
BASIC programs, or even just program fragments. How¬ 
ever, the companion disk contains only listings from the 
book, no translator of any kind. I found that completely 
misleading: there is no reason to mention an automatic 
translator on the cover, when no automatic translation 
software is included. Putting this misleading statement on 
the cover was probably just a publishing snafu and not a 
deliberate attempt to rip off the buyer, but the experience 
still sticks in my crawl. 
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Q I have written a free utility which can be run from Program Manager or 
replace Program Manager as the Windows shell. When it starts, it first has 
to determine whether or not it is the Windows shell since, if it is, it has to 
handle the 'load=' and 'run=' entries of win. ini and terminate Windows when 
it exits. I have tried using the 'sheil=' entry of system.ini and the Windows 
function AnyPopupO, but both methods have proven unreliable. For example, the 
user could edit system.ini at any time and change the shell* line. 

My current approach is to use the TooIHelp functions TaskFirstO and 
TaskNextO to make sure that the current task is the only one in the Windows 
session. This works in most systems, but I have had a couple of reports that 
seem to indicate that in some cases the utility fails to recognize that it is the 
shell and exits, leaving a void Windows session in which nothing can be done 
(except pressing Ctrl+Alt+Del). 

is it possible that some drivers loaded by Windows before the shell start 
their own (hidden) tasks? Is there a reliable way to ascertain if an instance is 
the current Windows shell? 

Juan M. Aguirregabiria 
wtpagagj@lg.ehu.es 


Paul Bonneau 


Send questions to Paul via internet as 

paul@rdpub.com 

from CompuServe: 

>INTERNET:paul@rdpub.com 
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1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700. 

Paul answers all electronic 
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respond personally to hard copy/disk 
messages. 


A Your theory about other tasks running before the Windows shell starts is 
right on the mark. For example, in Windows for Workgroups, the pro¬ 
grams printman.exe, clipsrv.exe, and netdde.exe can all be running before the 
shell is invoked. Also, I don't see any reason why a Windows driver would not 
be able to UinExecO a hidden task, as you suggest. 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft. 
























Listing 1 isshell.c — Program Manager’s shell 
detection algorithm 


j *****************************************************/ 

/* Isshell.c */ 

/* -- Program Manager-like code to determine If It */ 
/* Is the shell. */ 

J *****************************************************/ 

include <w1ndows.h> 


BOOL FIsShell0 

j***************************************************** j 

/* -- Return whether or not the current task Is the */ 
/* Windows shell. */ 

/*****************************************************/ 
{ 

char szBuf[128]; 

static char *pszShell = "PROGMAN.EXE"; 

1 nt cch; 

char far *1psz; 

If (GetNumTasksO == 1) 
return TRUE; 

GetPrlvateProflleStrlngC'Boot". "shell". pszShell, 
szBuf, slzeof szBuf, "system.Ini"); 
cch = Istrlen(pszShell); 

for (lpsz = szBuf; cch <= Istrlen(lpsz); lpsz++) 

{ 

char chT = 1psz[0]; 
lpszfcch] = 0; 

If (0 == lstrcmpl(pszShell, lpsz)) 
return TRUE; 

lpsz[cch] = chT; 

} 

return FALSE; 

} 

/* End of File */ 


Listing 2 isshell2.c — Improved shell detection 
algorithm 


J*****************************************************/ 

/* 1sshel12.c */ 

/* -- Improved verlon of code to determine If */ 
/* current task Is the shell. */ 

J ***************************************************** J 

^Include <windows.h> 

#1nclude <toolhelp.h> 

BOOL FIsShell(void) 

I*****************************************************f 

/* -- Return whether or not the current task Is the */ 
/* Windows shell. */ 

J*****************************************************/ 
{ 

TASKENTRY tke; 

tke.dwSize = slzeof tke: 

TaskFindHandle(&tke, GetCurrentTaskt)); 
return !IsTask(tke.hTaskParent); 

} 

/* End of File */ 


Program Manager uses code similar to that contained 
in isshell.c (Listing 1) to determine if it is running as the 
Windows shell. It first calls GetNumTasksO to determine the 
number of tasks currently running in the system. If the 
value is one, then only Program Manager can be running, 
so it must be the shell. Otherwise, a somewhat cheesy 
loop is executed to determine if the string 'PROG¬ 
MAN.EXE' (the comparison is case insensitive) exists any¬ 
where in the 'sheil=' line of the '[Boot]' section of sys¬ 
tem.ini. i call this loop cheesy because it really should 
parse the filename out of a path. As the code stands now, 
if your replacement shell resides in a directory called 
'progman.exe' (a DOS directory name can have an exten¬ 
sion, just as a filename can), and the user launches Pro¬ 
gram Manager from your replacement shell, then the loop 
will incorrectly report Program Manager as the shell. So if 
the user then closes Program Manager, it will incorrectly 
shut down Windows. Also, this technique is not bullet¬ 
proof. There is nothing to stop a user from renaming prog¬ 
man.exe to foo.exe and specifying 'shelMoo.exe'. In this 
case, if you are running Windows for Workgroups, closing 
Program Manager will not shut down Windows as it is 
supposed to. Unfortunately, Windows does not provide 
any additional support to help a task determine whether 
or not it is the shell. 

If you are content with making your application 'as 
correct as' Program Manager, then I would advise using a 
modified version of the code in isshell.c (Listing 1), but 
replacing the loop with code to extract the shell's filename 
from its path. 

You can go one step further, if you wish, by making 
use of the task database (TDB). All tasks possess this data 
structure, and a handle to it is returned by the Windows 
function GetCurrentTaskt). One of the entries in a TDB is 
the parent TDB handle. Normally, this is the TDB handle 
of the task that called MinExecO for the current task. But if 
the task was invoked from the 'shell=' line of system, ini, 
or if the task's parent has exited, then this value will not 
be a valid task database handle. Thus the return value of 
the documented API function IsTaskO, when passed the 
parent task database handle, can be used in conjunction 
with the other tests to better determine if a task is the 
shell. If the return value is TRUE, then the current task has 
a valid parent, so the current task cannot be the shell. 
isshell2.c (Listing 2) contains a modified value of FIs¬ 
Shell 0 that uses this technique instead of the 'cheesy' 
loop. [Note: In my first attempt at FIsShell0 I was reach¬ 
ing inside the undocumented TDB structure directly, but in 
a subsequent conversation, Mr. Aguirregabiria pointed out 
that ToolHelp provides the functionality required. The cur¬ 
rent version uses ToolHelp.] 

I've got one last point worth mentioning, and that is 
that Windows will automatically shut itself down when the 
last task exits. This makes the scenario you describe, 
where the user is left with a blank screen, somewhat mys¬ 
terious. I can't really think of a good explanation for this 
behavior, unless your shell has not cleanly exited. This 
can happen if you forget to call PostQuitMessageO from the 
UM_DESTROY case of your main window procedure, and your 


Page 70 — Windows/DOS Developer’s Journal 


July 1994 







application uses a traditional message loop that does not 
exit until GetMessageO returns false. 


=E3= 

Borland C++ v4.0 

J Symantec C++ v6.1 


Visual C++ vl .5 


Q The tear-off menu code in the March and April Win¬ 
dows/DOS Developer's Journal was excellent and was 
in fact precisely what I needed for a Program Manager 
replacement program I am currently writing. Unfortu¬ 
nately, there appears to be a small bug in the way it 
works with submenus, as can be seen in the demotear.exe 
program. Select "menu2' and tear it off, dragging it inside 
the parent window. Next, select that menu's submenu and 
tear that off and everything is okay. But if you tear off 
'menu2' and drag it outside the parent window, then 
when you tear off its submenu, bits of the ">' get carried 
over into the torn-off menu. 

I have one further question. My shell program remem¬ 
bers the size/position etc. of its windows and will reappear 
as it was left. How would I go about bringing up torn off 
menus in the same position they were left in? Presumably, 

I would have to simulate a menu selection, then call a 
new function which would do a BeginSnapO/EndSnapO and 
SetUindowPosO to the coordinates given. 

Paul Dolphin 
CIS: 100111,2427 

A The bug you noticed is a result of my over-optimizing 
the code in EndSnapO. The problem is that I am call¬ 
ing SetUindowPosO to show and position the tear-off win¬ 
dow before capturing the bitmap from the menu window. 
It (more or less) works as printed only because the tear-off 
window procedure basically does nothing on a UM_PAINT if 
the bitmap has not been captured, and because 
UM_ERASEBKGND is a no-op, since it is not passed through to 
DefUindowProcO. 

The code should first capture the bitmap, then display 
the tear-off with the call to SetUindowPosO. endsnap.c (List¬ 
ing 3) is the improved version of EndSnapO. When I was 
"optimizing' the code, I thought I could save some work 
by calling SetUindowPosO and using the menu window rec¬ 
tangle before deflating it (so that menu mode can be can¬ 
celled by posting a click outside the menu). But I forgot 
about the dependency and introduced the bug! 

Furthermore, restoring the call to SetUindowPosO to its 
proper place eliminates the need to call InvalidateRectO 
to discard the saved bits under the menu window. The 
bits will be discarded when SetUindowPosO repositions the 
tear-off window directly on top of the menu window. 

And as if I were not sufficiently embarrassed, there is 
another bug in the call to InflateRectO. My intent was to 
grab the upper left-hand corner of the menu window and 
fake a mouse click one pixel above and to the left. To 
accomplish this, I should have calculated the coordinate 
by calling InflateRectO, using 1 for both the X and Y 


Listing 3 endsnap.c — Revised version of 
EndSnapQ for tear-off menus 


/* endnsnap.c */ 

/* -- Bug-fix version of tearoff menu EndSnapO */ 
/* routine. */ 

j*★★★★*★★★★*★****★******★***★*★★★★*★*★*★★*★★★★★*★★★*★★j 

void EndSnapiPTOS ptos, HWND hwndMenu, BOOL fNew) 
/*****************************************************/ 
/* -- Capture the popped menu’s image into the tear- */ 


/* off's offscreen bitmap. */ 
/* -- Resize the tear-off to the menu's size. */ 
/* -- ptos : Tear-off. */ 
/* -- hwndMenu : USER’S menu window. */ 
/* -- fNew : If set, indicates tear-off was */ 


/* newly created. Begin drag if so. */ 

J*****************************************************/ 

{ 

HDC hdc: 

HBITMAP hbmpSav; 

RECT rect; 

POINT pt, dpt; 

GetWindowRectthwndMenu, &rect); /* Reposition */ 
pt = *(P0INT *)&rect.1 eft; 
dpt.x = rect.right - rect.left; /* tear-off. */ 
dpt.y = rect.bottom - rect.top; 

/* Cancel menu mode. */ 

Inf1ateRect(&rect, 1, 1); 

PostMessagethwndMenu, WM_LBUTT0ND0WN, 0, 

(LPARAMX LPPOINT)&rect); 

PostMessagethwndMenu, WM_LBUTT0NUP, 0, 
(LPARAM)(LPPOINT)&rect); 
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Listing 3 continued 


/* Get a bitmap for the tear-off. If this stuff */ 
/* fails, things will be ugly but won’t blow up. */ 
if (NULL 1= ptos->hbmp) /* Nuke old one. */ 

DeleteObj ect(ptos->hbmp); 
if (NULL != (hdc = GetDC(hwndMenu))) 

{ 

if (NULL != (ptos->hbmp = 
CreateCompatibleBitmapthdc, dpt.x, dpt.y))) 

{ 

hbmpSav = SelectObject(hdcMem, ptos->hbmp); 
BitBlt(hdcMem, 0, 0, dpt.x, dpt.y. hdc, 

0, 0, SRCCOPY); /* Capture bits. */ 
if (NULL 1 = hbmpSav) 

SelectObject(hdcMem, hbmpSav); 

} 

ReleaseDCthwndMenu, hdc); 

} 

SetWindowPos(ptos->hwnd, HWND_T0P, pt.x, 
pt.y - dyText, dpt.x, dpt.y + dyText, 
SWP_SHOWWINDOW I SWPJOACTIVATE I 
(fNew ? 0 : SWPJOZORDER)); 

if (fNew && GetKeyState(VK_RBUTTON) < 0) 

{ 

/* Force tear-off into drag mode. */ 
GetCursorPost&pt); 

ScreenToClient(ptos->hwnd, Jpt); 
PostHessage(ptos->hwnd, WM_RBUTT0ND0WN, 0, 

*(LPARAM *)&pt); 

) 

} 

/* End of File */ 


displacements. The bug is that I was using -1, the result 
being that the click ended up inside the menu window. 
The curious thing is that the menu was still dismissed. My 
guess is that the coordinates are ignored if a UM_LBUTTON- 
DOUN/UM_LBUTTONUP pair is received by the menu manager 
when the mouse is not physically down (that is, Get- 
KeyState(VK_LBUTTON) returns without the high bit set). At 
any rate, a future version of the menu manager may not 
behave precisely the same, so the code has been cor¬ 
rected in endsnap.c (Listing 3). 

To answer your question about displaying tear-offs at 
startup, one solution would be to call TrackPopupMenuO for 
each tear-off to redisplay, and to set a special flag inside 
tearoff.c such that when FilterTearOffO receives the 
UM_ENTERIDLE message once the menu is displayed, a fake 
HM_RBUTT0ND0WN message is posted to the owner window. 
This would fool tearoff.dll into thinking the user had 
right-clicked on a menu, causing it to generate a tear-off. 
After tearoff.dll dismissed the menu, TrackPopupMenuO 
would return, and you could loop until all of the tear-offs 
have been created. You could then reset the flag to cancel 
the special mode. 

Q I am a professional developer (and loyal Win - 
dows/DOS Developer's Journal subscriber) who has a 
Windows application that has mysteriously stopped work¬ 
ing in Windows version 3.0. I've gone to considerable 
trouble in maintaining 3.0/3.1 compatibility but now I'm 
at wits' end. 
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The program is written in Borland C++ v4.0, compiled 
in the large model (with only one data segment, which is 
movable), and (if this makes any difference) is an OWL 1.0 
application. When I load my application in Windows 3.0, 
one of three things happens. The most common is that I 
get a message box saying "Insufficient Memory to load 
application . . . close other windows." Sometimes I get a 
UAE, and sometimes I get a UAE that sends Windows 
back to the DOS prompt. 

Now, as I've said, the program has worked well until 
quite recently. One of the things I did was re-compile with 
Borland 4.0, although I can't remember if ever I got the 
version 4.0 application to run in Windows 3.0. After sev¬ 
eral messages to Borland via CompuServe, I was basically 
told that Windows 3.0 was not worth supporting. 

Another problem I'm having is that none of Borland's 
4.0 tools will run in Windows 3.0, which makes it tough to 
debug. Unfortunately, I don't have the debugging version 
of Windows 3.0, but in the debugging version of 3.1, I'm 
not getting any error messages or warnings. Neither do I 
have Windows 3.0A, which I'm told contained a lot of bug 
fixes. 

So my question is, do you have 
any ideas about what could be caus¬ 
ing this? If not, do you feel that Win¬ 
dows 3.0 is worth supporting? I 
guess I think that, as a developer 
aiming at a nontechnical audience, 

I'd like to have as few obstacles as 
possible when it comes to someone 
buying my package. But then again, 
maybe there aren't enough copies of 
3.0 to worry about. 

Todd Denlinger 
71404,1660 

A I think I have to agree with Bor¬ 
land. Microsoft's rollout of 3.1 
was the most successful ever, and at 
this point the only reason for an end 
user to continue using 3.0 is real 
mode. Unless your program only 
runs in real mode (which is obviously 
not the case), your audience will 
probably not include very many peo¬ 
ple with 80286's or better who are 
still running 3.0. End users possessing 
80286's or better who have not up¬ 
graded to 3.1 probably do not con¬ 
tribute much to new software sales. 

Also, the next version of Windows 
will be here in a few months (and it 
won't even support 286's). As a case 
in point, Microsoft's Consumer divi¬ 
sion, which targets the low end of 
the market, no longer releases soft¬ 
ware that runs on Windows 3.0. 

If you still feel you must support 
3.0, the best advice I can give you is 
to get hold of a copy of the 


udeb386.exe debugger that came with the 3.0 SDK. In fact, 
you may even be able to use the one that comes with 3.1 
(although I have never tried that particular combination). 
Make sure to load the 3.0 USER, GDI, and KERNEL symbol 
files. Then invoke Windows with the debugger, run your 
application, and once it UAEs look at the stack trace to 
help pinpoint the problem. 

You might also set a breakpoint on UinExecO just be¬ 
fore you launch your application, then set a breakpoint at 
the return address (which will be in the first two words on 
the stack - this will be an address inside Program Man¬ 
ager) and continue. If your application dies with the insuf¬ 
ficient memory message, see what value is being returned 
by UinExecO. It will be a number less than 32 to indicate a 
load failure. The SDK documentation for UinExecO lists the 
possible error return values. 

Alternatively, you could try and get WinSpector to run 
(this is most helpful when you have debugging symbols in 
the .exe) and see what information it places in its log file. 
This will not be as detailed as the information you can get 
with wdeb386.exe, but it may be enough. □ 
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In-Press Generates Source for Reports 

In-Press v2.0 is a new version of a publishing tool 
that helps DOS and Windows developers and end users 
create reports and forms. The tool supports PCL and Post¬ 
Script and can create fully banded reports tied to data, 
bar codes, and labels. It handles graphics (.bmp, .pcx, and 
. tif), multiple fonts, and wrapped text. In-Press v2.0 gen¬ 
erates source code for a variety of languages, including 
C/C++, CA-Clipper S'87, CA-Clipper 5.01 or above, CA- 


dBFast, CA-Realizer 2.0, Clarion, FoxPro 2.0/2.5 for DOS, 
FoxPro 2.5 for Windows, Paradox for Windows, Pascal, 
and Visual Basic for Windows and DOS. 

In-Press v2.0 costs $295. For more information, con¬ 
tact DABIWA Ltd., 301 Joseph Drive, West Chester, PA 
19380, (800) 533-3183 or (215) 692-8130;fax <215) 
692-8172. 


VERSIONS Adds Workgroup Support 

Omega Systems has updated VERSIONS, its Windows- 
based version control system. The new version provides 
workgroup support for network users. VERSIONS uses a 
project metaphor to ensure that users have the latest ver¬ 
sion of a file while preventing one person from overwrit¬ 
ing another's work. Users can also send any version of 
any file by email to other users on the network. The 
product provides point-and-dick access to previous ver¬ 


sions of files, and provides storage of both temporary 
and permanent versions of any file. 

VERSIONS vl .1 costs $279 but has an introductory 
price of $179. The upgrade is free to registered 1.0 users. 
For more information, contact Omega Systems, 5405 Al¬ 
ton Parkway, Suite 5A494, Irvine, CA 92714, (714) 253- 
6700; fax (714) 253-6712. 


OPTUNK v5.1 Features Royalty-Free Compression 


SLR Systems has removed the distribution fee from its 
compressing Windows linker, and has added support for 
Borland C++ v4.0, Microsoft Visual C++ vl .5, and Syman¬ 
tec C++ v6.1. OPTLINK v5.1 also allows developers to 
bind one or more resource files while linking. 

OPTLINK v5.1 is a faster, drop-in replacement for 
your compiler's linker. The ability to link in multiple .res 
files means that you can avoid using a single, monolithic 
. res file that must be updated when any single resource 


changes; this can further reduce your compile/edit/link 
cycle. An OPTLINK option lets you generate compressed 
versions of your .exe and .dll files, significantly reducing 
their disk space requirements. The compressed modules 
are seif loading and self extracting. 

OPTLINK v5.1 costs $350; upgrades cost $99. For 
more information, contact SLR Systems, Inc, 1622 N. 
Main Street Butler, PA 16001, (412) 282-0864;fax (412) 
282-7965. 


WIND/UGets Win32s API Support 

Bristol Technology has updated Wind/U, its Windows- 
to-UNIX portability toolkit, to include support for Mi¬ 
crosoft's Win32s API, which offers a subset of the 
complete Windows NT API. Wind/U v2.0 also provides 
compatibility with Visual C++, 32-bit edition, including 
support for the Microsoft Foundation Class library. A new 
utility, Wind/U Spy provides a UNIX version of the stand¬ 
ard Windows debugging tool; Wind/U Spy lets you moni¬ 
tor and inspect window messages. Wind/U v2.0 also 
includes Xprinter v2.2, the latest version of Bristol's print¬ 


ing library, which is integrated with Wind/U's graphical 
device interface; this version of Xprinter adds PCL4 sup¬ 
port to existing support for PCL5 and PostScript. Wind/U 
v2.0 also provides color palette support, allowing devel¬ 
opers to use Windows’ device-independent color capabili¬ 
ties on UNIX workstations. 

Wind/U v2.0 costs $9,950. For more information, con¬ 
tact Bristol Technology Inc, 241 Ethan Allen Highway, 
Ridgefield CT 06877, (203) 438-6969;fax (203) 438- 
5013. 
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Black Ice Ships Raster Capture Device Drivers 


Black Ice Software, makers of toolkits to handle vari¬ 
ous graphics file formats, has taken advantage of its 
graphics experience and the design of Windows to cre¬ 
ate two device drivers you can use to capture the output 
printing of any Windows applications. After you install 
either the Color Generic Device Driver or the Mono- 
Chrome Driver, you can connect them to either a fax 
port for faxing applications or a FILE port for capturing 
the printer output onto disk. Both drivers handle a vari¬ 
ety of image formats, including PCX, DCX, compressed 
and uncompressed DIBs, and TIFF/CCITT group 3. The 
drivers support standard American and European paper 
image sizes (letter, legal, A4, A5, etc.). 

The drivers provide standard (100x200) and fine 
(200x200) fax resolutions when connected to a fax port; 


high resolution (300x300) is available when connected 
to a file port. The drivers handle a variety of printer es¬ 
capes and offer limited DDE capability. All GDI functions 
are supported, as well as Adobe and TrueType fonts. The 
drivers support bitblts (all ROP codes), device-inde¬ 
pendent bitmaps (DIBs), and bitmaps over 64Kb. With 
the color device driver, pens can be any one of 16 solid 
colors, and non-solid color brushes are dithered to an 
8x8 matrix. 

The Color Generic and Monochrome Device Drivers 
cost $1,000 and are royalty-free. For more information, 
contact Black Ice Software, Inc, 1 13 Route 122, Amherst, 
NH 03031, (603) 673-1019; fax (603) 672-4112. 


Updatelt! Provides Multi-Platform Compressed Updates/Patches 


Updateltl is a new multi-platform file update utility 
that lets developers ship compressed, password-pro¬ 
tected change files for incremental product updates, bug 
fixes, and so on, without having to ship a complete new 
copy of the product. The product comes with a GUI inter¬ 
face for building and maintaining change files. It can gen¬ 
erate either a change file, or a . exe that includes the 
change file and the patch engine that applies the change 


to the customer's copy. The resulting .exe can run under 
DOS, Windows, OS/2 character-mode, and OS/2 Presenta¬ 
tion Manager. 

Updateltl costs $249. For more information, contact 

Innovative Data Concepts, 122 North York Road, Suite 5, 
Hatboro, PA 19040, (215) 443-9705 or (800) 926-4551; 
fax (215) 443-9753. 


Sheridan Ships New VB Custom Controls 

Designer Widgets is a new set of Visual Basic custom 
controls: a dockable toolbar control, an index tabs con¬ 
trol, and a forms control. 

The dockable toolbar control lets you create floating 
toolbars of buttons that users can 'dock' (attach) to the 
top, sides, or bottom of an MDI form. When the toolbar 
is not docked, the user can resize and reshape the float¬ 
ing palette of buttons as needed. 

The index tabs control lets you create dialogs that 
use the new Chicago-style look for multi-screen dialogs - 
a set of index tabs at the top of the dialog lets the user 
switch among multiple dialogs. The tabs are active at de¬ 


sign time so you can place controls by selecting the de¬ 
sired tab and drawing controls right on the card. 

The FormFX control lets you customize forms by ma¬ 
nipulating captions and borders. You can include multi- 
line text and pictures, alter the height, adjust the fonts 
and alignment, or add a 3-D look. You can lock the form 
at runtime to maintain size and position, and you can 
lock the form so that it never goes behind another win¬ 
dow. 

Designer Widgets costs $129. For more information, 
contact Sheridan Software Systems, 35 Pinelawn Road, 
Suite 206E, Melville, NY 11747, (516) 753-0985;fax (516) 
753-3661; BBS (516) 753-5452. 


Stirling Updates Installation Utility 

InstallSHIELD is a utility that helps Windows develop¬ 
ers quickly develop installation disks. Version 2.0 in¬ 
cludes a new compression engine that allows developers 
to compress and decompress any number of files and 
subdirectories with a single command. FileSets is a new 
feature that lets developers selectively install files based 
on user selections without worrying about which disk 
contains which files. FileSets tell the user which disks to 
insert while minimizing the number of times disks have 
to be inserted. 

The new version includes three ready-to-customize 
examples of installation styles, as well as 35 prebuilt 


modular dialog boxes most often needed by installation 
programs. You can use the prebuilt dialogs or customize 
them for your own installation. New DLL support gives 
your install script access to custom DLLs or the entire 
Windows API. This version also provides new functions 
to modify or add to system files, such as config.sys, auto¬ 
exec.bat, Min. ini, and system, ini. You can now install de¬ 
vice drivers in system, ini with a single statement. 

InstallSHIELD v2.0 costs $395; upgrades cost $249. 
For more information, contact Stirling Technologies, Inc, 

172 Old Mill Drive, Schaumburg, IL 60193, (708) 307- 
9197; fax (708) 307-9340; CompuServe (CO STIRLING). 
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Mirage Provides Windows Environment under UNIX 


Mirage, from Software Pundits, is a new Windows 
software development environment for UNIX, allowing 
Microsoft Windows developers to migrate their applica¬ 
tions to UNIX platforms. Mirage provides Windows func¬ 
tionality by translating more than 550 function calls into 
equivalent X window and Motif/Open Look functions 
while complying with the Windows-based and X-based 
interface standards. The product also supports OLE and 
DDE. 

The Mirage software development environment con¬ 
sists of a runtime library, PostScript print driver, resource 


compiler, porting guide, programmer's reference, installa¬ 
tion guide, and sample programs. Mirage is available for 
Solaris 1 .x and 2.x for SPARC and X86, SCO Open Sys¬ 
tems Software 3.0, HP-UX 9.0, AIX 3.2, OSF/1, UnixWare 
1.0, X Window System Version 11 Release 4 or 5, Motif 
1.1 or 1.2. Win32s support is scheduled for the middle of 
1994 and Win32 support is planned. 

Mirage costs $7,500. For more information, contact 
Software Pundits, Inc, 25 Burlington Mall Road, 
Burlington, MA, (617) 229-6655;fax (617) 229-6660. 


GraphicsObjects/V Provides Smalltalk/V Graphics 


BOK Technologies is shipping a new high-level, plat¬ 
form-independent graphics class library for Smalltalk/V 
that spans Windows, Win32, OS/2, and the Mac. Graphic- 
sObjects/V is a set of classes that encapsulate the operat¬ 
ing system's graphics API and existing low-level graphics 
methods in Smalltalk/V. 

The library supports objects including geometric 
shapes (such as Bezier curves, polygons, ellipses, 
wedges, arcs), a structured graphics hierarchy (collection, 
set, dictionary of graphics, and so on), 2-D geometrical 
transformations, prebuilt shapes (arrows, nodes, and so 
on), drawing attributes, and text blocks that support mul¬ 


tiple fonts, styles, and colors. The library provides meth¬ 
ods that let you display, perform hit testing on, position, 
align, and arrange graphics objects. You can save and re¬ 
trieve graphics objects using the storing/retrieving 
mechanism defined in Smalltalk/V. 

GraphicsObjects/V costs $145US (educational institu¬ 
tions are eligible for a 60% discount) and includes com¬ 
plete source code. For more information, contact BOK 
Technologies, Inc, 5476 Trans-Island Avenue, Montreal 
(Quebec), CanadaH3W3A8, (514)485-6690;fax(514) 
485-2095; CIS 72730,655. 


WinRT Offers DDK Alternative 

BlueWater Systems has released the WinRT Tool Kit, 
a software package designed to give Windows NT pro¬ 
grammers access to hardware without having to write a 
device driver. The toolkit lets programmers directly ac¬ 
cess port I/O, memory I/O, and interrupts to access un¬ 
supported peripherals and custom hardware, such as 
data acquisition cards, I/O interfaces, etc. The WinRT de¬ 
vice driver provides the services that let you avoid hav¬ 


ing to use Microsoft's DDK to create a device driver to ac¬ 
cess the hardware. 

The WinRT Tool Kit costs $595 for single users and in¬ 
cludes six months of technical support. For more informa¬ 
tion, contact BlueWater Systems, 144 RailroadAve., Suite 
207, Edmonds, WA 98020; (206) 771-3610; fax (206) 
771-7758. 


Greenleaf CommLib Goes 32-Bit 


Greenleaf Software has upgraded its asynchronous 
communication library to support Win32, Phar Lap's TNT 
DOS Extender, and Rational's DOS/4g and to include 
two new language-independent DLLs for Windows and 
Windows NT, as well as message notification for commu¬ 
nications events. The library supports various makes of 
multiport boards, the 16550 UART FIFO modes, numer¬ 


ous file transfer protocols, and flow control. In addition 
to ZMODEM, YMODEM, XMODEM, and Kermit, the new 
version now supports the CompuServe B+ protocol. 

Greenleaf CommLib v5.0 prices start at $359. For 
more information, contact Greenleaf Software, Inc, 
16479 Dallas Pkwy., Ste 570, Dallas, TX 75248, (800) 
523-9830 or (214) 248-2561;fax (214) 248-7830. 


PowerBASIC Offers Professional Edition 

PowerBASIC, Inc., has released the PowerBASIC Pro¬ 
fessional Edition, which bundles the PowerBASIC DOS 
programming language with the PowerBASIC Developer 
Kit for Windows 3.1 (PBDK). PBDK encapsulates the Win¬ 
dows API and offers a simplified method of program¬ 
ming for an event-driven environment. With PBDK, each 
application runs in its own virtual machine with preemp¬ 


tive multitasking. The product is compatible with third- 
party resource editors and supports DDE, the clipboard, 
and DLL access. 

PowerBASIC Professional Edition costs $299; up¬ 
grades cost $149. For more information, contact Power¬ 
BASIC Inc, 316 Middle Valley Center, Carmel, CA 92923, 
(408) 659-8000; fax (408) 659-8008). 
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AshWinDM Distributes Software Builds across Network 


AshWinDM is a new distributed make utility from 
Creative Interaction, Inc. AshWinDM automates and con¬ 
trols distributed compilation while providing dependent 
and centralized linking. The product lets you take advan¬ 
tage of unused CPU time on other machines on your net¬ 
work to distribute the compilation process, cutting 
compilation time by as much as 75 percent. 


AshWinDM costs $495 for an SDK and from $995 for 
a five-user network license to $5,295 for an unlimited 
network license. For more information, contact Creative 
Interaction,Inc,800EastowneDrive,Suite 111,Chapel 
Hill, NC27514,1919) 489-6300; fax (919) 489-2180. 


Menai Creates File Access Library 

Gamelon is a new file access library that lets program¬ 
mers store program data as objects. The product helps 
automate the task of designing and using files that con¬ 
tain application data structures. The library comes with a 
browser that allows inspection and modification of any 
Gamelon file, a compiler that creates a Gamelon file 
from a text specification, a decompiler that creates a text 
specification from any Gamelon file, and a journal re¬ 


cover program that rebuilds a Gamelon file from its jour¬ 
nal. 

Gamelon costs $395 for Windows 3.x; $495 for Win¬ 
dows NT and OS/2. For more information, contact Menai 
Corporation, 1010 El Camino Real, Suite 370, Menlo Park, 
CA 94025-4336, (415) 617-5730;fax (415) 853-6453; 
BBS (415) 617-5726. 


CyberEDIT Enters Programming Editor Fray 


CyberEDIT is a programmer's editor for Windows. 

The product includes a file version history that works like 
a personal version control system. Each file save adds 
any changes to the version history, allowing any pre¬ 
vious file version to be recalled. The editor also supports 
a hex display mode with simultaneous binary and ASCII 
display that allows editing of non-text files, including in¬ 
serting and deleting bytes. External DOS and Windows 
tools can be integrated into the main menu. 

Search and replace options let you reassign regular 
expression metacharacters so they do not clash with pro¬ 
gramming language tokens, and the editor can handle 
multi-file search and replace. The product supports syn¬ 


tax-aware color highlighting as well as a pre-compile 
check for mismatched braces, brackets, and parentheses. 
A built-in C compiler supports application-specific exten¬ 
sions, and C-like source text can be recompiled to alter 
keyboard mappings (it comes with popular mappings 
such as Brief, Word Star, and CUA). There is no limit on 
the size or number of files being edited, and the editor 
supports unlimited undo and redo. 

CyberEDIT costs $179. For more information, contact 
Triherent Data Systems, 1200 Dale Avenue, #58, Moun¬ 
tain View, CA 94040, (800) 700-1237 or (415) 428-1237; 
fax (415) 967-3471. 


zApp Factory Provides Visual Design for zApp 


Inmark Development Corporation has released zApp 
Factory for Windows, an integrated visual design environ¬ 
ment and code generator for zApp, the company's C++ 
application framework. zApp Factory lets you visually in¬ 
teract with the underlying zApp classes to build Windows 
applications with toolbars, status lines, controls, and so 
on. A tool palette lets you drag and drop controls, bit¬ 
maps, and icons onto windows, dialogs, and toolbars. 
Alignment tools provide accurate positioning. A project 
manager provides a graphical representation of all ob¬ 
jects within a project. Objects can be copied and pasted 
both within an application and between projects. 

A prototype mode lets you view the flow of the appli¬ 
cation and see how objects will interact without waiting 


for a compile and link. After prototyping your user inter¬ 
face, you can press a button to generate zApp source 
code to implement the interface. You can modify the gen¬ 
erated code either through zApp Factory or with your fa¬ 
vorite editor; your modifications are protected so you 
can continue to use zApp Factory to regenerate code. 

zApp Factory costs $495. For more information, con¬ 
tact Inmark Development Corporation, 2065 Landings 
Drive, Mountain View, CA 94043, (415) 691-9000;fax 
(415)691-9099; BBS (415)691-9990; CompuServe (CO 
INMARK); Internet: sales@inmark.com or support@in- 
mark.com. 


New Programming Editor Runs on Windows, NT, and OS/2 


RimStar Technology Inc. is shipping the RimStar Pro¬ 
grammer's Editor for OS/2, Windows, and Windows NT. 
The product offers a configurable, multithreaded, multi- 
document interface and a variety of keyboard mapping 
options for programmers migrating from other editors. 
The editor includes language-specific syntax coloring, a 
macro language, a C source browser, unlimited files and 
windows, no file size limit, and a redo/undo capability. 


The editor can use multithreading to perform multiple 
compilations at once. Other features include keystroke 
macro recording, smart indenting, bookmarks, and on¬ 
line documentation. 

The RimStar Programmer's Editor costs $249 for Win¬ 
dows or Windows NT and $299 for OS/2 v2.x. For more 
information, contact RimStar Technology, Inc, 91 Halls 
Mill Road, Newflelds, NH 03856, (603) 778-2500. 
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Readers' Forum 


From CompuServe 
Subject: BC++ 4 DLL fix 

I caught a bit of Ron Burk's thread in the Borland fo¬ 
rum about exception handling and DLLs and then I read 
with great interest his mention of a 'fix' for this (in W/DDJ 
V5, N5). I have put off using BC++ 4 until I can more 
easily compile without having to redefine low-level func¬ 
tions and I was unable to find anything in their forum 
about the fixes Mr. Burk mentioned. Do you have any 
further word on this? 

Philip SIoss 
71756,2613 

To recap the problem, a Borland C++ v4.0 DLL will (unless you 
happen to not link in the offending startup code or jump through 
many hoops to avoid doing so) corrupt the DGROUP of most any 
non-Borland C++ v4.0 application that perfonvs the initial load of 
that DLL. I covered this in more detail in the May installment of my 
Practical C++ column. At the time of that writing, Michael Hyman 
of Borland predicted a fix would arrive by May. 

As of this writing (June 7), no fixes have arrived. However, 
Borland has announced that registered Borland C++ v4.0 own¬ 
ers can call Borland at (800) 645-4559 and order their "service 
upgrade" CD-ROM for $9.95 ($29.95for diskettes). On calling to 
inquire about the upgrade, I was told that it will not ship for 
four to six weeks. The service upgrade is said to contain new 
features and provide faster compilation, in addition to fixing the 
onerous exception handling bug. 

Will there be a free upgrade for the price of a download 
from CompuServe? I'll have to wait and see like everybody else. 

I was wrong the last time I said a fix will be available by the 
time you read this, so this time I will not claim that there is any 
fix until I actually have it in my hot little hands! -rib 


Ron, 

While researching Windows Help for one of our up¬ 
coming products I ran across your article in Doctor Dobb's 
Journal, June 1993. Very good and helpful, too. 

it mentions you're working on a book (tentatively) enti¬ 
tled "WinHelp for Programmers and Technical Writers.' 
Which publisher? And what's the current status on this? 
Should I go down to the bookstore and pore over cata¬ 
logs, or should I hold off for a while? I'll keep an eye out 
and see if I can track down the appropriate issues of 
W/DDJ as well. Thanks for the information. 

John McMullen 
johnmc@mks.com 


Ron, 

I am a subscriber to Windows/DOS Developer's Journal. 
However, I remember seeing an article in DDJ (Sept. 1993) 
in the "Undocumented Corner' which referred to you writ¬ 
ing a book tentatively called 'WinHelp for Programmers 
and Technical Writers.' 

Is your book in publication? Do you know of any other 
reference material regarding creating help files and 
printed documentation? Thanks in advance for any help 
you can provide in this area. 

Best regards, 

Tom Carroll 
uunetibigmaxicarroli 


Ron: 

Saw your article in Dr. Dobb's Journal for June 1993. It 
mentioned you will be coming out with a book entitled 
'WinHelp for Programmers and Technical Writers.' 

I called our local bookstore . . . they have no record of 
it yet. When do you expect to publish it? 

Thanks. 

Richard Boyd 
boydr@huachuca-emh12.army.mil 

Ok, it's time for me to fess up and decrease the stream of 
"where's that book?" messages in my mailbox (that DDJ article 
will apparently haunt me forever). The truth is, I'm not sure if 
that WinHelp book of mine will ever get done. At the moment, 
I'm even toying with the idea of creating a product rather than 
a book. I'm not sure that project would ever get done either, but 
it would at least be a change of pace to start saying "the prod¬ 
uct isn't done" instead of "the book isn't done"! 

On the bright side, Jim Mischel has written a book on Win¬ 
Help programming that may be out by the time you read this. I 
think it is from Wiley and, while I have not seen It yet, based on 
the WinHelp article he sold us ("Undocumented WinHelp Mac¬ 
ros", in the January 1994 W/DDJ), I have reason to believe his 
book will be good. The book "Developing Online Help for Win¬ 
dows" by Boggan, Farkas, and Welinske (from Sams) is a great 
alternative to Microsoft's WinHelp documentation. It's not pri¬ 
marily oriented towards programmers, but it is currently the 
only book on WinHelp that I know of and is well worth the 
price if you are just starting with WinHelp, or want insight into 
organizing and managing a large WinHelp project. Also, the 
best place to pose WinHelp questions of all sorts is in the Win¬ 
Help section of the WINSDK forum on CompuServe. Microsoft's 
support people do a phenomenal job there of answering ques¬ 
tions. -rib 
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■ Tech Tips 



Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks —those 
clever pieces of code to 
make things work the 
way they should! You'll 
receive at least $50 for 
each tip that we print 
Send your submissions to.- 
Tech Tips 
Leor Zolman 
74 Marblehead Street 
North Reading, MA 01864 
leor@bdsoft.com. 


Yielding from a VxD; 
A Windows Cold Boot 


Leor is taking a well-deserved vacation from Tech Tips this month, so I am standing 
in for him. Look for Leor to reappear next month, -rib 


Yielding from a VxD 


Paula Tomlinson 
paulat@vcd.hp.com 


When you're executing code in a VxD for a significant amount of time with¬ 
out yielding not only do other VMs not get to execute their code but even 
hardware interrupts are not processed. To demonstrate this, I added a tight 
loop of code in the protected-mode API routine of one of my VxDS. Note that 
this routine assumes all callers are requesting the version number of the VxD. 

; protected-mode API, declared 
; in DeclareJ/irtualJJevice 
BeginProc VxD_ProtectAPI, Public 
mov [ebp].Client_Fl ags, 0 
mov [ebp].Cl i ent_AX, VERSIONJIUMBER 
; but before returning, waste some 
; time in a loop! xor eax, eax 
KillSomeTime: 
inc eax 

cmp eax, 00ffffffh 
jl KillSomeTime 
ret 

EndProc VxD_ProtectAPI 



Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 12 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (“ . . . !uunet!rdpub! ronb"). 
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Then 1 created a little test program that simply calls this 
VxD's protected-mode API routine (using the standard INT 
2Fh, function 1684h interface). On my 80486, it takes a couple 
of seconds to run through that loop, and while that loop is 
executing in my VxD, the mouse is frozen. Users tend to 
have very little patience with a frozen mouse and will reboot 
before too many seconds have passed - not to mention the 
background programs, such as communication programs, 
that are relying on timely processing of hardware interrupts. 

To solve this problem, right after the KillSomeTime label, 

I added a call to the following ZxD_Yield routine. 

BeginProc VxD_Yieid 

VMMCall Enable_VM_Ints 

Push_Client_State 

VMMCall Begin_Nest_Exec 

VMMCall Resurae_Exec 

VMMCall End_Nest_Exec 

Pop_Client_State 

ret 

EndProc VxD_Yield 



A Windows 3.1 Cold Boot Program 


Stefano Corgnati 
corgnati@yapp.enet.dec.com 


Borland C++ v4.0 
Symantec C++ v6.1 
Visual C++ vl .5 


When testing my Windows 3.1 client-server applica¬ 
tions, I need a way to perform a cold reboot of the PC. 
The server runs on DEC Ultrix or VAX/VMS, and the clients 
run on Windows 3.1 ExitklindowsO is not appropriate for 
my purpose because it exits Windows cleanly; I need to 
simulate a power down. 


According to the Virtual Device Adaptation Guide (in¬ 
cluded in the Windows 3.1 Device Driver Kit), calling the 
EnableJMJnts service is sort of analogous to executing an 
sti instruction. Enabl e_VM_Ints enables hardware interrupts 
while the current virtual machine is executing. But, in or¬ 
der to service the hardware interrupt, the current virtual 
machine needs to resume its execution. This is accom¬ 
plished by calling the Resume_Exec service (which can only 
be called from within a nested execution block). 

Adding the call to this VxD_Yield routine prevents the 
mouse from being frozen while the VxD executes its loop 
of code. The downside is that this yielding is very costly in 
terms of speed. What started out as a two- or three-sec¬ 
ond delay now stretches into the minutes! For this reason, 
I changed the logic in my VxD to call the VxD_Yield service 
less often - often enough to have responsive mouse 
movement but not so frequently as to slow down the exe¬ 
cution of my VxD too much. 


Listing 1 reboot, c — Rebooting by jumping into 

the BIOS 


II Original version of reboot routine. 


int rebootO 
{ 

_asm mov ax, 0306h // 
_asm int 31h // 

II 

_asm push si // 

_asm push di // 


get switch mode entry point 
call DPMI; it returns in SI:DX the 
CS:IP of the switch mode routine 
real mode switch routine CS 
real mode switch routine IP 


_asm mov sijffffh // CS of code to be executed after the 

// processor is switched in real mode 

_asm mov di.0 // IP of code to be executed after the 

// processor is switched 
// in real mode 

_asm retf // jmp far to real mode switch routine 

} 

/* End of File */ 


I 












Listing 2 reboot2.c — Rebooting via the keyboard 
controller 


// Revised reboot function that uses keyboard controller 


int reboot!) 
( 


_asm 

mov blJFEh 


_asm 

xor cx.cx 

// 64K timeout 

cmdwait 



_asm 

in al,64h 

// get status 

_asm 

nextl: 

jmp nextl 

// let bus settle 

_asm 

next2: 

jmp next2 


_asm 

test al ,2 


_asm 

jz send 



To accomplish this, I wrote a simple program that per¬ 
forms a cold boot after some random number of seconds 
have elapsed. I use it when testing my client-server appli¬ 
cations. I run Windows from autoexec.bat, then I put the 
"reboot' application and my client application in the 
Startup. After at most one minute, this program reboots 
the PC, without exiting cleanly from Windows: it simulates 
a power off, or a bad crash. Then the PC reboots, and the 
test is repeated endlessly without human intervention. 

To reboot the machine from Windows 3.1, I had to do 
a trick: I switch the processor from protected mode to real 
mode using DPMI 0.9 services, then I jump to the proces¬ 
sor's power-on entry point, that is 0FFFFh:0. reboot, c (List¬ 
ing 1) shows the function that does the boot. This is the 
same as turning the power off and on again. Be careful 
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Phone Sound: Simple! 


For Windows/DOS Voice Mail & Fax Developers 




Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts 
and save time with VFEdit ®' 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/FDLL™, our Tel I/F 
Dynamic Link Library 

3. Audio Tool Box™ 
converts to and from 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 & 
8 at any sample rate 1 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware 1 

5. Add Text-to-Speech 
capability to your apps with 
Vox Fonts™, our "software 
only" text-to-speech library! 


Order Now! 1-800-234-VISI 


I Voice Information Svstems: 24 N Mcrion Ave, Brvn Mawr. Pa 19010 I 

Tel 215-747-5035/ BBS 310-392-6610/ Fax: 1-800-234-FX1T 
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Add a Drag ‘n’ Drop Style 
Graphical Interface to your 
Visual C++ Application with 
Drag-it Class Library 

=> Concentrate on your application while 
Drag-it handles the graphics ! 

=> Create Custom Palette by drawing 
using Drag-it Builder ! 

=> Track user's actions at a higher level 
of abstraction than mouse moves! 

Only $495 including source 

To order call or fax today 
1-800-3-DRAG IT 

Performix 

6618 Daryn Dr., Westhills, CA 91307 
818-992-0840 fax: 818-347-9455 
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SDK PROGRAMMERS: 

Want to subclass SDK API's 
such as TEXT0UT()? 


TrapFunc Library for Windows 

This programming library will give you the 
ability to subclass virtually any Windows 3.1 
SDK/DDK API or third-party DLL function 
export with your own user defined callback 
functions. Consider the power you would have 
if you could replace a Windows API such as 
TextOut() with your own callback function. 
(Library distribution is royalty-free.) $500 

CALL TODAY TO PLACE YOUR 
ORDER: (818) 345-2200 
FAX: (818) 345-8905 

"Download our program samples" 

BBS: (818) 343-8433 
14.4K, 9600, 

2400,1200 


Blue Lagoon 


SOFTWARE 



SLSOOPE ™ 

The PC K3-232 Analyzer 

5I_SC0PE a comprehensive serial 
datascope enables users to examine 
activity on any serial line at baud 
rates up to 115k. Capture data to RAM 
and disk while viewing activity in 
selectable data formats including 
ASCII and EBCDIC. Pattern searching, 
microsecond timestamp accuracy, 
keyboard interaction, macros, and 
more! 

- Manual and cable included. 

- 3 O day money back guarantee. 

For orders/info contact: 



63 Rock Cut Rd. 
Newburgh. NY 12550 

(914) 567-0805 
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CC-RIDER 


C and C++ 

— BROWSING 
FOR ANY EDITOR! 

Source Code Analysis and Documentation 



file Edit View £e«tch Window Ioolt Option* Help 



NEW v5for WINDOWS, DOS & OS/2 

Western Wares 

Free Demo (303) 327-4898 
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Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 


lor Windows 3.x 


0 Shared DLL resources 
supports multiple applications 
and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled). 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference. 

0 Control panel utility allows 
dynamic DLL configuration, 

0 WINDOWS.TXT compatibilty 
for DOS support. 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr., Atlanta, GA 30350 

ffi TEL/FAX (404) 992-0536 

Also available at the Programmer's Connection! 
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C++ SOURCE CODE 


T n fV The World s Leading 

lmageoelt 

Presents 

ISCL™ containing more than 
140 volumes of high 
quality C++ source code 
(both shareware and 
freeware) including: 

• Neural Nets • Compilers 
Communications • GUIs 
Tutorials • Matrix/Numerical 
• Memory Management • Databases/ 
ISAM • Utilities (e.g. Demangler, Beautifier, etc.) 

• Graphics • And Much, Much More 

All For Only $99" (on CD Rom) 

Also available on 3.5” and 5 1/4” 

Contact: ImageSoft Incorporated 

2 Haven Avenue • Port Washington, New York 11050 
Tel: (516) 767-2233, Fax: (718) 767-4307 
EMAIL: iscl@image.linet.org 
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We Understand The 
Programmer's Mind 


When the country's top firms look for the 
best developers available, they turn to 
Bateman. Why? Because we specialize in 
Microsoft Windows, NT, OS/2 and Macin¬ 
tosh recruiting nationwide. So if it's time for 
a career move, give us a call. We under¬ 
stand your skills, and the marketplace for 
them... we understand you. 

□Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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Diskette I/O 

Code Libraries 
Device Drivers 

VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

W V 7aI PY PO Box 5700 
L/ V vl-V^k. Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 


Tools for Novell's Btrieve-;: 

Bsupport III Bsupport II 

Bed it 3.0 - Btrieve file viewer/edilor. 
Banalyze 2.0 - Btrieve app. debugger. 

Brun 2.2 • BUTIL replacement plus source. 
Bereatc 2.0 - file creation utility. 

Bcheck 2.0 - Btrieve file analyzer. 

Xsupport 1.0 - build data dictionary 
(.DDF) for Access, OV, 
Crystal Rpts. 

Xport 2.0 - export/import CDF, SDF, 
dBASE. 

Call for information on additional 
products and FREE demo! 

Information Architects, Inc. p h: (H0 0) 359-2721 
3J30 Pine Tree Road (517)887-8000 

Lansing, MI 48911 Fax: (517) 887-2366 
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BRIDG IT™ 

Your Windows & DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll+ and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tei:(602) 991-7272 • Fax:(602) 483-7674 
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COMPUTER 
BOOKS 50% OFF! 

The Book Rack has the best titles 
from these great publishers & more: 

IDG 

SAMS 

QUE 

MIS: Press 
Microsoft Press 
Sybex 

at HALF OFF cover prices! For a 
current list of available titles, call or fax: 

The Book Rack 

708-627-8122; Fax 708-932-9070 

Your Discount Book Source 

We ship anywhere! 

VISA/MasterCard/Discover accepted 


July 1994 


FREE Legacy Code Report 


How to Eliminate 87% 
of C Programming Errors 
in less than 2 hours! 

This valuable report reveals secrets 
known by less than 5% of all profes¬ 
sional programmers. These little 
known but powerful techniques prev¬ 
ent almost 90% of all design and main¬ 
tenance errors with the guarantee that 
your compiled code will be virtually 
error free. Limited quantity available. 


TCP/IP Tools 


Why write low-level TCP/IP code when you 
can quickly and easily incorporate 
high-level components? GCP++ lets you 
add TCP/IP protocols to your application 
without coding them yourself! 

• Rapid prototyping support 

• Windows Sockets 1.1 SDK 

• VBX and DLL interfaces 

. VT-220, TCP, UDP, FPT, TFTP & TELNET 

• VT-220 for Workgroups site licenses 
•NO ROYALTIES! 

Consulting/custom development services available. 

Tel 315.841.8106 
FAX 315.841.8107 



Deansboro, NY 13328 COMMUHKATWHS 


Logic Technologies 

1 (619) 228-9653. FAX 1 (619) 369-1185 
56089 29 Palms Hwy. Ste 254-WD. Yucca Valley. CA 92284 
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Listing 2 

continued 

_asm 

loop cmdwait 

asm 

jmp error 


send: 



_asm 

mov al,bl 


asm 

out 64h,al 


asm 

jmp next3 

// let bus settle 

next3: 



asm 

jmp next4 


next4: 



_asm 

xor cx.cx 


accept: 



asm 

in al,64h 


asm 

jmp next5 

// let bus settle 

next5: 



_asm 

jmp next6 



when doing this, as this kind of hard rebooting can leave 
data unwritten to your file system (just as pulling the 
power plug at random can). You will probably want to 
disable any write-behind caching you are using if you 
want to use this function for testing. 

Leor had tried this tip out, but it didn't always reboot without 
hanging his machine. I tried it out myself and my machine hung 
too. I knew from past experience that this method of booting 
worked pretty reliably on my old XT running DOS, but I didn't 
know if this was reliable from enhanced-mode Windows or not. 
Fortunately, Frank Van Gilluwe's excellent new book, The Un¬ 
documented PC, answers this and a great many other ques¬ 
tions. Van Gilluwe states flatly that this method works reliably 
only on an 8088 machine, since the BIOS expects a variety of 
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Chart A New Course! 


If your goal is to become a top 
industry programmer— and you have 
a desire to work with O/S, debuggers 
and programming tools—then 
Nu-Mega wants to talk to you. We’re 
looking for an extraordinary new 
talent...sharp and intuitive with a 
need to excel. You’ll work and learn 
with the industry’s best to really push 
the limits in development tools for 
Windows NT, Windows and DOS. 
Fluency in C/C++ and assembly 
languages at the systems and 
applications levels required. 


For consideration, send or FAX resume to: 



Human Resources 
Nu-Mega Technologies, Inc. 

P.O. Box 7780 
Nashua, NH 03060-7780 
FAX: 603-889-1135 



Export Your 
Software Now 


Let us help you increase your export sales! 
Octagon develops foreign markets for 
small and medium size software publish¬ 
ers, including start-ups. 

• Quickly penetrate new markets 

• Conserve scarce internal resources 

• Find the best distributors and 
republishers for your product 

• All fees based on your success 




Octagon Trade 
Group, Inc. 


Suite 102, 3020 Pickett Rd., #759 
Durham, NC 27705 
Tel: 919-493-1651 Fax:919-493-1915 
E-Mail: octagon@mercury.interpath.net 
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Sentry Spelling-Checker Engine 


Add a spelling checker to your 
DOS/Windows applications! 
■ 100,000-word dictionary 
■3 kinds of user dictionaries 
■$299 US / $585 Source 


ThesDB Thesaurus Library 


Add a thesaurus to your 
DOS/Windows applications! 

1110,000 synonyms/20,000 key words 
I$299 US/$585 Source 


Both products feature: 
■C/C++/Visual Basic API 

■ DOS obj libs & Windows DLL 

■ No royalties or runtime fees 
■ANSI C source code available 


f Wi nfe.viy'e.e. Software. ZJnc. 

43 Rueter St. Nepean, Ont. Canada K2J 3Z9 

(613) 825-6271 CompuServe: 72060,3056 
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DICE IS LOOKING FOR 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search sen/ice 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 



DATA PROCESSING 
I NDEPENDENT 
CONSULTANT’S 
E XCHANGE 


ONLINE Number 
515 - 280-3423 

Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
_ 515-280-1144 _ 
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Spend your time writing your App 
...Not wading through 
DDK documentation!! 
Hardware control for Win32™Apps | 
- without the Device Driver Kit 
/Port I/O 

/Memory I/O 

/Interrupts 

Ask us about Alpha™, PowerPC™ and 
Chicago versions. 

BlueWater Systems I 
(206)771-3610 | 
% (206)771-7758 Fax I 

nt TF 73514 132@compuserve com 

iUMfkl NT version $595 
Royalty free runtime 
Visa,MC, Approved PO | 
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All of these discs are Unconditionally Guaranteed! 

★ Cica MS Windows CDROM: 4000 Windows 
programs-quarterly updates! $29.95* 

★ C User Group Library CDROM: Collection 
of user supported C source code $49.95* 

★ Source Code CDROM: 650 MB of Unix & 

DOS source code $39.95 

★ Simtel MSDOS CDROM: Classic:650MB 
Shareware/Freeware for MSDOS $29.95* 

★ Hobbes OS/2 CDROM: 600 MB current 
Shareware/Freeware for OS/2 $29.95* 

★ Yggdrasil Linux CDROM: 32 bit O/S for PC 
w/GNU &X11. Source code $49.95 

★ FreeBSD CDROM: Berkeley BSD, 32 bit 

O/S for PC, w/ GNU & XI1 $39.95 

★ Internet Info CDROM: 12,000 computer, 
network, and internet documents $39.95 

★ Giga Games CDROM: 3000 hot Games for 

MSDOS and Windows $39.95* 

"■shareware requires separate payment to authors if found useful 

Pick up the phone and Call Now! 
1 -800-786-9907 EKBI - 

1-510-674-0783 • FAX 1-510-674-0821 

email: orders@cdrom.com 

4041 Pike lane, Suite D-691 Concord, CA 94520 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only $129 + $5 s&h ($15 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 
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UNIVERSITY of W ASHINGTON 

College of Engineering 

The Department of Technical Communication 
presents 

a two-day course: 

Designing and Writing Effective 
Online Help and 
Online Corporate Information 

for more information, contact 
Susan G. Stone 

Engineering Professional Programs 
Tel. (206) 543-5539 
Fax (206) 543-2352 
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Windows 

Developer Jobs 


Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 
Mac, CASE, Video, Realtime. 
Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1-800-231-5920 



Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SPI-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 854-9444 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
^CompuServe: 71250,3001; Genie: D.SMALL6 J 
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/ OPTFFT 


^Opt-Tech Sort/M erg 

Optimized Fast Fourier Transform 
(FFT) Library for DOS 


New -Version 5 

♦ Object file for linking with C or 

C++ routines 

♦ Written in assembler for 2X speed 
improvement 

♦ Up to 4096 real or complex points 


High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 

♦ NO ROYALTIES 

♦ 30 day money-back guarantee 

plus $5 s & H 

Specify disk size. 


METRON Engineering, Inc. 

P.O.Box 14395 

Huntsville, AL 35815 

205-650-5250 

CIS: 76300, 3441 


Opt-Tech Data Processing 

P.O. Box 678 

Zephyr Cove, NV 89448 

^ (702) 588-3737 
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NetUcense m 

Don't Release Without It! 

Are you losing sales to customers who purchase one copy of your 
product and allow an entire company to use it simultaneously on its 
local area network? 

With NetLicense maintaining a constant watch, your product will 
automatically prevent users from running illegal copies on a LAN. It 
wont prevent illicit copying, but it will prevent illicit execution. If the 
network is running on their workstation, their illegal copies of your 
software wont. 

• Completely self contained. 

• Prevents violations on servers or any workstation. 

• Serializes each copy of your product. 

• Tamper-resistant user registration. 

• Add to your product in less than a day. 

• Includes example programs with source code. 

• Royalty-free object code license. 

• Indudes Winl 6 and Win32 versions. 

Introductory Price 

$595.00 


22845 NE 8th Street Suit© 314 

Redmond, WA 98053-7299 // /S>LC// /L C7 

Phone 206-836-0111 /^0/7T/0/TT7/Z0/'7 

FAX: 206-868-0550 L.U/JUU/C/L/U/ / 

□ Request 105 on Reader Service Card □ 

July 1994 



2 ADDITIONAL RS-232 PORTS 
FOR WINDOWS & 05/21 


* Two RS-232 Ports 

* 16 Sit Address decode allows 
Windows & OS/2, COM3:, 

COM4: etc. 


* Individually Selectable Address 
& Interrupt (2-5,10,11,12 & 15) 

* 16550s Standard 

* FREE Technical jti? 

Support 

* MasterCard, 'jjtitt 

VISA, & COD 

* 30 Day Money 

Sack Guarantee ifUeCSSHF 

Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 

See for yourself. Download your 
unlimited eval copy. 

Try a complete, free eval copy tonightl 

* Part #3066 

Our BBS: 206-935-5198 

i n6c/. tyOV.UU IIIII1U W- J 

NET: ftp.halcyon.com /local/wilson 

SEALEVEL SYSTEMS, INC 

5E4LEVEL Z%i™ 29657 

W COMMUNICATIONS & 1/0 £03-343-4343 

CompuServe: WINAPA, Sec. 15 

AOL: WindowWare 

Direct: 1-800-762-8383 

Wilson WindowWare, inc. 

FAX 503-343-3067 



□ Request 115 on Reader Service Card □ 0 Request 223 on Reader Service Card p 

Windows/DOS Developer’s Journal — Page 85 
































Listing 2 continued 


next6: 




_asm 

test al.2 



_asm 

jz ok 



_asm 

loop accept 



error: 




_asm 

mov ax,® 

// 

failed 

_asm 

jmp retstatus 



ok: 




_asm 

mov ax.l 

it 

succeeded 

_asm 

jmp retstatus 




retstatus: 


} 

/* End of File */ 


things to be true (e.g., it expects the machine to be in real 
mode) that may not be true on an 80286 or better. In its place, 
he recommends using the keyboard controller to safely boot the 
machine. 

One of the good things about Frank's book is that it is rife 
with code examples that do useful tasks related to the subjects 
he is discussing. I was able to quickly rip code out of the book to 
use the keyboard controller method of resetting the system. The 
result is in reboot2. c (Listing 2) and it seems to work fine on my 
machine. Check out Frank's book for more complete details on 
rebooting and talking to the keyboard controller, as well as a 
great many other topics, -rib □ 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 


SmartHeap“is an ANSI portable malloc 
and new for DOS, Windows, NT, OS/2, 
UNIX and other platforms. Proprietary 
algorithms deliver speed improvements 
up to 100X versus other commercial 
mallocs, especially for large heaps in the 
presence of virtual memory. SmartHeap 
localizes data structures in their own 
heaps. Plus it includes numerous fixed- 
size and handle-based APIs. Debugging 
facilities isolate leakage, overwrites, 
double-freeing, wild pointers, and many 
other errors to responsible file/line/pass 
count. Exceptionally reliable - used by 
a "who's who” of commercial software 
publishers. No royalties. Source avail¬ 
able. 

CALL FOR FREE 

WHITE PAPER, BENCHMARKS, 
AND ERROR REPORTS 

MicroQuill 

Software Publishing, Inc. 

800-441-7822 / 206-525-8218 
FAX 206-525-8309 

CompuServe: 70751,2443 
Internet: devtools@microquill.win.net 


TEXT-TO-SPEECH 

SDK! 


For use in Windows 3.1 applications 

Convert any written text into clear 
human sounding synthetic speech 

Standard English Language Kit includes: 

•Sample programs 

•API function reference & programming guide 
•DLL and evaluator 

•French, German & Spanish also available 

Set your product apart! 
Speech is the ultimate 
user-interface! 

LERNOUT & HAUSPIE 

icisjaarfSIPRQDUCTSl 

800 W. Cummings Park, Suite 3100, Woburn, MA 01801 
(617)932-4118x202 Fax:(617)932-9209 

(800) 252-4999x202 


"If you can’t See it or Measure it... 
you can’t understand it!" 

PinPoint™ 

two new Windows tools for 
one low price: $199 

• Visual Tracer™: See program 
execution flow in real time 

• Visual Profiler™: Measure function 
calling frequencies and execution 
times to 1ms. Easy-to-use graphical 
display. 

Works AUTOMATICALLY with C/C++ and 
Microsoft™ Visual Basic" 

Avanti Software, Inc. 

1-800-758-7011 
International +1-415-329-8999 
FAX 1-415-329-8722 

90 day no-quibble guarantee 



WinTodsnf can deliver ft! 

W/nToAsm 

Disassembles MS-Windows EXEs, 
DRVs, DLLs, and VxDs, by 
segment, range, or export. 

Labels exported and imported 
functions, VxD services, 
control proc, API entry, etc. 

Generates segment, export, 
import, and header tables. 

Supports batch-mode tagging of 
functions and data items 

ResToRC 

Decompiles resources to a RC file. 

Vornact 

Extracts VxDs from Win386. 

All for only $94.95! 

30-day Money-Back Guarantee 

Eclectic Software 

937 Jungfrau Court 
Milpitas,CA 95035 

_ (408)262-3264 Voice/FAX 
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Macro 
Language 
"To Go" 


Easily add Netlogic’s full featured 
macro language facility to your 
Windows application — at a fraction of 
the time and cost of developing it your¬ 
self. Seamless integration. Full basic 
syntax. Integrated editor and debug¬ 
ger. Extendable and modifiable. For 
more information: Netlogic Inc., 915 
Broadway, New York, NY 10010. 
Phone 800-638-0048. Fax 212-533-9524 

Pro Macro ™ 

Your Application’s Shortcut to Power 
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S^The 

[TREASURE' 
HUNTERS 

In the world of software, it is 
ail too easy to lose a valuable 
treasure: by editing and saving 
a program, overwriting a vital 
previous version. 

To prevent you from having to 
search in vain for buried treasures, 
ARIS VERSION TRACKING SYSTEM 
for Windows enables you to access 
and use previous program versions. 
AVTS. A gem of a program 
at a diamond price. 


a 


ARIS 

Information-Systems 


Parkstr.2, 85646 Anzing, Germany 
Phone +49-8121-45624, Fax +49-8121-45625 \ 
From the USA, call 
Phone 01149-8121-45624 
, Fax 01149-8121-45625 
Email: CompuServe 100042,1707 
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IMWHelp 


Window/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212) 319-1903 

425 Madison Ave., New York, NY 10017 
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Add ZIP/UNZIP Power to your app's! 


% Dvnn7IP Data 

I l/|IIMAir Compression 
I Toolkit for MicrosoffWindows' 

Finally there's an intelligent and easy 
way to incorporate reading and writing 
of industry stondord ZIP files into your 
Windows programs, without having to 
"shell" to DOS. 

DynaZIP is a high-quality ROYAL1Y-FREE 
set of DLLs that give you a robust API for 
reading, testing, creoting, writing, and 
updoting your ZIP files. Supports C/C+ + 
and VB; includes source code for a 
high-quality Windows-based ZIP shell, 
comprehensive test/diagnostic tools, 
and full documentotion/help system. 
Versions available for Win3.1 and NT. 

Now only $ 249.00 w/30-day 
no-risk guarantee! 

Call today, toll free: (800) 962-2949 


Inner Media. Inc.. Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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USING C++ OBJECTS WITH 
SQL RDBMS’s??? 

The Solution Isn’t Obvious, It's 

SUBTLEWARE™ FOR C++/SQL 


* Uses your C++ Class 
Definitions 

* Fully supports the C++ 
Object Model 

* Automatically generates 
SQL mapping code 

* Provides Portable Object 
Persistence across a variety 
of SQL RDBMS’s 


* Works with your existing 
RDBMS’s and tools 

* Shortens your development 
and maintenance time 

* Fits into most C++ 
environments, including 
Borland C++ and Visual 
C++ 


ANSI SQL Engine 
Introductory Price $299 


CALL 1-508-663-5584 


30 Day Money Back Guarantee 
Ask about availability of other 
/^Database Specific Modules/ 



Subtle Software 
Inc. 


1 Albion Road 
Billerica, MA 01821 
FAX: 508-663-5685 


© 1994 Subde Software, Inc Subtieware™ is a trademark of Subde Software. Inc. 
Other product names are trademarks of their respective holders 
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I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

Windows/DOS 

□ DEVELOPER S JOURNAL 

Call 913-841-1631 today for 
information about 
advertising opportunities in 

Windows/DOS Developer’s Journal. 

Advanced. Serious. 

Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Christine - Midwest I Edwin - West 
913-841-1622 1913-841-6733 1913-841-1626 


C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION ! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL : C-DOC ($1991 All 5programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deterred reports. 

• 30-DAY Money-back guarantee CALL NOW 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (9051-858-4466 

L5N-4M1 Demos/BBS (9051-858-1916 


see AD INDEX for our larger ad 


□ Request 134 on Reader Service Card D 


IPX VBX/DLL 
NetBIOS VBX 


These custom controls allow a Visual 
Basic developer to write distributed, 
client/server applications. A separate 
Windows dynamic-link library (DLL) is 
available for IPX. 



10201 W. Markham, Ste. 101 
Little Rock, Arkansas 72205 


Tel (501) 221-3600 • Fax (501) 221-7412 



Sound & Vision Edition 


A hypertext / hypermedia Help Database Development Kit 
with two royalty free help engines and a help compiler with a 
built in cross reference tool. The current version is 10.0. 

ONE source generates help for MANY target formats like: 
Windows, OS/2, Microsoft Multimedia Viewer, THELP, 
DESQview/X, QuickHelp, PopHelp, word processors, text 
documents with table of contents, glossary and index. 


Write Once Help Many ! 


Supports Topics, PopUps, Links, Keywords, text formats, 
navigational and structural facilities, target code insertion, 
multiple module files, automatic Pascal/C/C++ reference 
generation, exception handling, graphics, sound, groups, 
multiple file target databases, Application Launch, user 
defined link templates, auto exports creation, and more. 

Get a demo version of HLPDK from CompuServe, Internet, 
PsL and other popular catalogs and BBS's. 

Order your copy from Hyper Act, Inc. or PsL today! 


$50 

+S&H 


Hyper Act, Inc. 

P.O.Box 5517, Coralville, IA 52241 
Tel/Fax (319)351-8413 
CompuServe 76350,333 
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formats, and the only guarant 


AccuSoft is now the recognized provider of 
the highest quality imaging toolkits in the 
world. Our performance, compatibility, 
ease-of-use, service, and our AccuSoft Image 
Guarantee have earned us this distinction. 
Our libraries save you hundreds of hours of 
work and provide your application with a 
unique advantage: Guaranteed Format Support. 

Incredibly Easy To Use 

Our toolkits are so easy to use that it should 
take you less than an hour to add complete 
image import, export, conversion, display, 
printing and scanning support to your appli¬ 
cation. If you need to work at a lower level 
for special situations, we have functions for 
that, too! 

Story Behind The Guarantee 

Having offered this Guarantee for over two 
years, we have collected several thousand 
(weird, but perfectly valid) images. Now¬ 
adays we see very few problem images. If we 
do, the image is usually corrupted or invalid, 
yet we are able to provide solutions for these 
images as well. 

Guaranteed, to read all raster 
images in existence in the 
supported formats. If you 
can find a valid image we 
don’t read, send it to us and 
we will make it work. 




Performance Tuned By Experts 

We at AccuSoft have an unyielding commit¬ 
ment to achieving the highest performance 
possible for all our products. This, of course, 
means that your 
products will also 
achieve greater 


performance. 


AccuSoft is the Fastest! 


Support For All Platforms 

AccuSoft has versions for all major platforms 
including DOS, 32-bit DOS, Clipper, 
Foxpro, Windows™, Visual Basic®, 
Windows NT, OS/2, Chicago, Macintosh, 
and UNIX. We can also port to other sys¬ 
tems upon request. 

Complete Compression 

All forms of compression are supported 
including JPEG, Group III, Group IV, 
Packbits, LZW, Huffman, and more. Read 
any image format, then convert to any other 
format-with only two function calls! 

Features, Features, Features 

We provide a complete set of functions for 
printing, scanning, display, image processing 
and image handling. All printers and TWAIN 
scanners are supported with simple function 
calls. The image printing engine produces 
high quality output regardless of the printer. 
The display engine provides high-speed (up 
to 50 times faster than Windows) and high 
quality display for all types of images and 


display modes. Our image processing func¬ 
tions include zoom, pan, scroll, invert, 
rotate, resize, sharpen, blur, contrast, bright¬ 
ness, palette optimization, color reduction, 
matrix convolutions and much more. 

Visual Basic® Versions 

We have special versions for Visual Basic 
that provide all the power of the DLL in the 
form of a Custom Control. We even have 
the world's only 32-bit VBX for Windows 
3.1. Extremely Fast! 

Pro Gold Versions 

Our Pro Gold libraries represent the most 
advanced performance and features available 
in the world. We have Pro Gold versions 
available for Windows 3.1 (no special hard¬ 
ware or drivers required), Mac, UNIX and 
others. When your application demands 
unbeatable performance, go with Pro Gold. 

Call Now To Order 


800 - 525-3577 

Risk-Free 30-day money back guarantee on all 16-bit products. 


ccuS«ft 


High Performance Imaging 


©Copyright 1994 AccuSoft Corporation. All Rights Reserved. AccuSoft Corporation 112 Turnpike Road Westborough, MA 01581 TEL:(508) 898-2770 FAX: (508) 898-9662 
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WINDOWS! 
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Debug Windows at the systems level! 


Soft-ICE/W takes you inside Windows! Debug and explore with power 
and flexibility not found in any other Windows debugger! Soft-ICE/W 
allows you to debug at the systems or applications level or simply learn 
the inner workings of Windows. 

• Debug VxD's, drivers and interrupt routines at source level 

• Debug interactions between DOS T&SR's and Windows Apps 

• Debug programs in DOS boxes 

• Display valuable system information 

(from the total memory occupied by a Windows application, to the 
complex internal structures of Windows) 

Soft-ICE/W uses the 386/486 architecture to provide break point 
capabilities that normally require external hardware. Nu-Mega, which 
pioneered this technology with the introduction of its award winning 
Soft/ICE for DOS, now gives Windows programmers the same debug¬ 
ging power,.. and still at a software price. 

Ow-n the debugger that combines the best "view" of Windows internals 
with the most powerful break points of any software debugger. 

Soft-ICE/W . . . Only $ 386 


"While you may choose to keep your own favorite debugger 
for simple work, Soft-ICE/W will soon become mandatory 
equipment for serious windows debugging." 

PC Magazine 
June 1992 


- WHAT THE EXPERTS ARE SAYING - 

"Soft-ICE for Windows is great! It helped me 
find, in fifteen minutes, a killer bug in a 
Windows vir ual device driver that had 
eluded two pf.ople for several months. I 
can't see doing Windows development of 
any kind - whether writing Windows 
applications, device drivers, or even DOS 
programs that have to run under Windows - 
without it. In addition to being great for 
finding bugs, Soft-ICE for Windows has been 
essential for my work on a forthcoming book: 
on Undocumented Windows . Soft-ICE for 
Windows goes anywhere and does 
everything, so it's essential for anyone who 
wants to poke around inside Windows 
Enhanced mode. DOS programmers will find 
it a perfect way to learn how the Windows 
DOS extender and DPMI server work, and 
how Windows interacts with DOS. Windows 
Enhanced mode is the hacker's paradise of 
the 90s, ond Soft-ICE for Windows is the tool 
that every serious Windows or DOS hacker 
will need. Nu-Mega has done a brilliant 
job!" 

Andrew Schulman 

Software Engineer 

Editor. unj tea tms ai a sWQS 

Coauthor. Undocumented Windows 



889-2386 

889-1135 
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RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 


603-595-0386 
24 HOUR BBS 


MICROSOFT WINDOWS IS A REGISTERED TRADEMARK OF MICROSOFT CORP. Soft-ICE/W AND CV/1 ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 
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